CList-Calc is a standard list-based calculation plugin for Obsidian. It helps you quickly perform calculations on lists, making it ideal for tracking daily or monthly expenses, budgets, project costs, shopping lists, or personal finance tracking. With CList-Calc, you can use simple or nested lists to organize your data and apply calculations like sum, average, count, min/max, and more, directly in your Obsidian notes.

Example use cases:

• Daily Expenses – Track meals, transport, and shopping costs.
• Monthly Budget – Calculate total spending across multiple categories.
• Shopping List – Sum item costs automatically.
• Project Costs – Manage expenses for materials, labor, and overhead.
• Holiday Planning – Track hotel, transport, and activity costs.
• Personal Finance – Keep track of income, bills, and savings.

Release Version: V1.0

Language: #javascript

Support: All platforms.

Author:Abdur-Nur-Porag

Email: [email protected]

Clist-Calc use

BlockName:clist-calc

Available Function

General Function:

1. Sum(var)
2. Avg(var)//Avoid it insted of it use Count()
3. Count(var)
4. Max(var)
5. Min(var)
6. Median(var)
7. Mode(var)
8. Range(var)
9. MaxLabel(var)
10. MinLabel(var)
11. AscadingList(var)
12. DscadingList(var)
13. TotalChecked(var)
14. TotalUnChecked(var)
15. TotalCheckbox(var)
16. StdDev(var)
17. Var(var)

Math Function

Math Function:
1. Root(var||num)
2. nRoot(value,n)
3. Power(value,power)
4. Floor(var||num)
5. Round(var||num)
6. Ceil(var||num)
7. Abs(var||num)
8. Log(var||num)
9. Ln(var||num)
10. Sin(var||num)
11. Cos(var||num)
12. Tan(var||num)
13. Cot(var||num)
14. Sec(var||num)
15. Cosec(var||num)
16. ASin(var||num)// inverse of sin
17. ACos(var||num)// inverse of cos
18. ATan(var||num)// inverse of tan

Angle in degree

Access var name

General list:
            Var name,
For nested list:
            ParentName.childName...

How to use?

Copy after here and paste in obsidian notes and see. I think you will understand.

Simple brief

As beginner you first follow the simple list. Then go nested. ⚠️ must use code block name clist-calc.

List Syntex:

Simple List

• MyBugget
  • Egg=199*30
  • Chicken= 189*230

Total Cost=Sum(MyBugget)

Simple List

• MyCost
  • Bus Ticket=600
  • Plane Ticket=8000

Total Cost=Sum(MyCost)

Nested List

• Holiday Cost
  • Hotel
    • Alpha Sea=10000
    • Black Core=20000
  • Airplane
    • Dhaka to Chattogram = 23000
    • Chottogram to Katmandu =45000

Hotel Cost=Sum(Holiday Cost.Hotel)
Airplane Cost=Sum(Holiday Cost.Airplane)
Total Cost=Hotel Cost+Airplane Cost

College Tour

• College Tour
  • Present Student
    • Group Green = 80
    • Group Yellow = 70
    • Group Red = 120
  • Expense
    • Group Green = 4500
    • Group Yellow = 6500
    • Group Red = 5000
  • Food
    • Morning = 500
    • Noon = 500
    • Evening = 1000
    • Nignt = 500

Total Students = Sum(College Tour.Present Student)
Group Green Budget= Sum(College Tour.Present Student.Group Green)*Sum(College Tour.Expense.Group Green)+" BDT"
Group Yellow Budget=Sum(College Tour.Present Student.Group Yellow)*Sum(College Tour.Expense.Group Yellow)+" BDT"
Group Red Budget =Sum(College Tour.Present Student.Group Red)*Sum(College Tour.Expense.Group Red)+" BDT"

Total Budget= Group Green Budget +Group Yellow Budget+ Group Red Budget +" BDT"

Total Food Expense= Sum(College Tour.Present Student)*Sum(College Tour.Food) +" BDT"

Left Money = Total Budget - Total Food Expense +" BDT"

Comments And Show

/*use multiple line comment*/
// use for hide
"Showing value"//use for showing something

Example:

/*this is comment*/
Print=" Here showing text"
// hiddenNum=10;
 hiddenNun=hiddenNum
 

Demo Project

• MyFinance
  • DailyExpenses
    • Breakfast = 150
    • Lunch = 300
    • Dinner = 250
    • Transport = 120
  • MonthlyBills
    • Rent = 15000
    • Utilities
      • Electricity = 2200
      • Water = 500
      • Internet = 1200
    • Subscriptions
      • Netflix = 800
      • Spotify = 500
      • News = 300
  • Savings
    • FixedDeposit = 10000
    • EmergencyFund = 5000
  • Investments
    • Stock
      • Tesla = 20000
      • Apple = 15000
    • MutualFund
      • FundA = 5000
      • FundB = 10000

/* General Function Examples */
TotalDaily = Sum(MyFinance.DailyExpenses)
AverageDaily = Avg(MyFinance.DailyExpenses)
MaxExpense = Max(MyFinance.DailyExpenses)
MinExpense = Min(MyFinance.DailyExpenses)
CountExpenses = Count(MyFinance.DailyExpenses)
RangeExpenses = Range(MyFinance.DailyExpenses)
StdDevExpenses = StdDev(MyFinance.DailyExpenses)
VarExpenses = Var(MyFinance.DailyExpenses)
TotalCheckedItems = TotalChecked(MyFinance.Savings)
TotalUnCheckedItems = TotalUnChecked(MyFinance.Savings)
AscDailyExpenses = AscadingList(MyFinance.DailyExpenses)
DescDailyExpenses = DscadingList(MyFinance.DailyExpenses)
MaxLabelExpense = MaxLabel(MyFinance.DailyExpenses)
MinLabelExpense = MinLabel(MyFinance.DailyExpenses)

/* Nested Totals */
TotalUtilities = Sum(MyFinance.MonthlyBills.Utilities)
TotalSubscriptions = Sum(MyFinance.MonthlyBills.Subscriptions)
TotalBills = Sum(MyFinance.MonthlyBills)
TotalInvestments = Sum(MyFinance.Investments.Stock) + Sum(MyFinance.Investments.MutualFund)
TotalFinance = Sum(MyFinance.DailyExpenses) + TotalBills + TotalInvestments + Sum(MyFinance.Savings)

🌟🌟 If find bug, or anything else please create issues in github.

"CList Calc is open source"