README file from
GithubCarbon CList-Calc
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
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
- Present Student
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
- Stock
- DailyExpenses
/* 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"