pem(1)

💖 pem(1) — GNU personal expenses manager 💖

okay bestie, listen up, this is pem, straight outta section 1 of the General Commands Manual, and it's about to be your new main character. she tracks your money. your coins. your whole bag. 🎀

---

✨ NAME ✨

pem — GNU personal expenses manager 🫶

---

✨ SYNOPSIS ✨

pem [OPTIONS] [<description> <amount> ...]

---

✨ DESCRIPTION ✨

GNU Pem is that handy little tool that helps you keep track of your personal income and expenses. and like, needless to say?? using pem is extremely simple and easy. literally a command of this exact form is ALL it takes:

$ pem "Bus ticket" 10.75
$ pem -f myexpenses.txt Breakfast 20

Pem stores these details in a CSV file, named after the current month, and placed in the ~/.pem directory under your $HOME directory. wanna use some other file instead? just hit it with the -f option, easy. also, heads up: each amount is considered an expenditure unless you indicate otherwise with -e. 💅

---

🏷️ Tags/Categories

================

okay so from version 0.7.4, pem introduced support for tags & categories of records. you can tag an income and/or expense record like:

$ pem -c bills "Cell phone bill" 830.50
$ pem -c 'travel fun leisure' "Trip to Goa" 4500

These are saved with the tags bills & travel fun leisure respectively. and later?? you can see very useful reports showing your category wise expense traits. ✨

Now pem also facilitates filtering of records using tags and description. Note that, while filtering records, pem first looks into the tags and when they don't match, goes for the description field. Ex. to see all your expenses on travel, you can say:

$ pem -s travel
$ pem -m travel

While the first will list all your travel expenses in a month; the latter will show the cumulative results for each month till date. 👑

Other than this, pem supports these following options:

---

✨ OPTIONS ✨

• -b, --bare — show unformatted report 🍓
• -c, --category <name> — categorise/tag your expenses 💖
• -e, --earned — indicates income 💰
• -f, --file <name> — specify file name 📁
• -s [n] — show daily report with total after [n] days 📅
• -m [n] — show monthly report with total after [n] months 🌙
• -C — show category/tag-wise report 🏷️
• -t, --total — shows just the total when used it with -s 🧮
• -M <mm> — select the start month (01 <= mm <= 12) 🌸
• -N <mm> — select an end month (01 <= mm <= 12) 🌸
• -Y <yy> — select an year (00 <= yy <= 99) ⭐
• -h, --help — show this help 🙈
• -v, --version — show version information 💜

---

✨ ENVIRONMENT ✨

• PEMTIME — Pem recognizes the PEMTIME environment variable. PEMTIME defines the format in which you want the Date & Time to be displayed. for example, if you export PEMTIME="%F", the date "May 31 2007" will be displayed as 2007-05-31. for more information/options please see strftime(3). 🕰️

---

✨ REPORTING BUGS ✨

Report bugs to <pj.pandit@yahoo.co.in> 🐛 (yes bestie, actually email them, do not just vague-post about it)

---

✨ AUTHOR ✨

Written by Prasad J Pandit

Initial category patch: John Westlund

---

lowkey none of this is scary, it's just a CSV and a vibe check. go log your bus ticket. periodt. 💅✨

---

and that's the whole page, bestie — brought to you by pem(1) from the General Commands Manual 🎀🦋 go be financially iconic 👑