Pocket Ledger by Techyeye98 is an offline expense tracker and personal finance ledger for Android, with optional Google Sheets sync to a Sheet you own. Track bank, cash and card accounts, income, expenses, transfers and money owed. A separate itemized bill splitter handles shared bills and partial repayments. iPhone uses its own, simpler Apple Shortcut for recording expenses in Google Sheets.
Download Android APK directly · Get iPhone Shortcut directly
Android 8.0+ · Signed Android APK · iPhone uses a separate, simpler Shortcut
- Offline first: record Android expenses without a Pocket Ledger account or Google Sheet.
- Your own spreadsheet: optionally sync your financial ledger to a Google Sheet in your Drive.
- Shared money stays clear: distinguish your spending from friends' shares, loans and linked repayments.
- Itemized bill splitting: divide items, tax, discounts and payments; import a receipt image or scanned PDF for on-device English text recognition and review.
- Quick Android entry: use the home-screen widget or Quick Settings tile, then find transactions in Activity.
This is the Techyeye98/Pocket-Ledger project. Use the links above to identify this app among other products with the same name. The Android download is a signed APK distributed through this website. Standalone split bills stay on the current phone and are excluded from ledger backups and Sheets sync.
Android 1.0.0 · version code 25 · Android 8.0+ · app name Pocket Ledger. Latest stable release.
This README describes the current source and website downloads. The illustrated Android handbook is available as short web chapters and a linked 14-page PDF; the earlier expense-only PDF is retained as an archive. The Android download is built with the release configuration and preserves the existing signing certificate.
| Platform | What you get | Sheet template |
|---|---|---|
| Android | Native offline ledger, accounts, people dues, widgets and standalone bill splitting | |
| iOS | Apple Shortcut that sends expenses to its own Sheet |
Start with the website, Android APK, or iOS Shortcut. Use the matching platform’s Sheet and script. Android-only functionality below does not apply to the iOS Shortcut.
Create bank, cash, wallet and credit-card accounts. Set an actual opening balance and its starting date; opening money is not income. Account balances apply financial movements from that starting point onward.
Home separates available money, card dues and current net balance, alongside period income and expenses. Date filters change period activity; current balances are a separate snapshot.
Connect payment names such as UPI or a debit card to the account they use. A payment label alone does not create an opening balance. Older expenses without account assignments remain visible and can be linked later. Configure default/last-used payment choices, reorder accounts, archive them, or record a balance adjustment with a reason. Archived accounts retain their balances and history; only unused accounts can be deleted.
| Entry | How it works |
|---|---|
| Expense | Money spent, with an optional personal/friend allocation and Need / Want tag. |
| Income | Money received into an account, with configurable income categories. |
| Transfer | Moves money between accounts, including bank-to-cash movements or a credit-card payment. It is not another expense. |
| Shared expense | You pay the gross amount; only your allocation is personal spending, and friends’ allocations become receivables. |
| Lend / Borrow | Tracks money to receive/pay separately from everyday spending and income. |
| Friend paid | Your personal expense paid by someone else, creating an amount owed to them. |
| Repayment | Settles a specific original item and person, with partial repayments supported. |
| Merchant refund | Links to an expense; personal and friend refunded shares cannot exceed the original allocations. |
| Write-off / forgiven debt | Resolves an outstanding amount without pretending money moved between accounts. A receivable write-off counts as expense; forgiven payable counts as income. |
| Balance adjustment | Corrects an account balance with a required reason. |
Example: pay ₹900 from a bank account, allocate ₹300 to yourself and ₹600 to a friend. The bank falls by ₹900, personal spending is ₹300, and Lena / Dena shows ₹600 to receive. When the friend pays you back, the linked repayment settles that receivable without counting as salary.
Use Lena / Dena to see separate receive/pay totals, open items and linked history. Shared/linked entries should be edited in the app. Validation rejects inconsistent splits, excess refunds/repayments, invalid references and unsupported account routes.
- Quick expense entry with category, payment, date/time, optional note and optional Need / Want classification.
- A resizable home-screen widget and Quick Settings tile for expense entry; the widget opens a temporary entry sheet over the launcher.
- Home summaries, category charts and Needs / Wants / Untagged insights with entry drill-down.
- Searchable Activity with period, category, payment and spending-type filters, sorting, edit/delete, and quick tagging.
- Light, dark and system themes; currency, category/payment ordering and entry defaults; a Show / Hide control for recent entries.
- Home checks public GitHub Releases for stable app updates, with a one-hour cooldown. A newer version shows an update card linking to the latest release page; Settings → Check for updates bypasses the cooldown. Offline/API failures do not block the ledger. Settings also includes the repository star link, Made by Namya Mehta and Telegram @Techyeye.
Need / Want is a choice, not an automatic judgment. Transfers and friends’ shares are not personal shopping. Refunds reduce personal spending, while linked repayments resolve dues.
Open Home → Tools → Split bills. Add or reuse saved friends, enter items, choose consumers and portions, confirm the tax percentage, and enter the final amount payable after discounts (including tax). Tax is calculated from the original item subtotal. Record multiple or partial payments and inspect reimbursements/settlements.
Import an image or scanned PDF for on-device English text recognition, then review the extracted items, totals and tax rate. Files are limited to 20 MB and five PDF pages. Manual entry remains available; recognition can make mistakes and does not replace your review. There is no built-in camera-capture flow.
Split bills and saved split friends are separate from the financial ledger. They do not automatically post expenses or affect account balances, income/spending reports or Lena / Dena. They stay on the current phone and are excluded from JSON export/import, Sheet sync, Android cloud backup and device transfer. Uninstalling or clearing app data can lose them.
- Install the APK and open Pocket Ledger. Offline tracking does not require a Google Sheet or a Pocket Ledger account.
- Open Accounts and add the balances you actually have, with correct opening dates. Link payment methods to accounts.
- Add expenses/income; use More for transfers and lending. Use Lena / Dena for linked settlements.
- Review Home and Activity. Use Split bills separately when you need an item-by-item calculation.
- Export a JSON backup before changing phones or resetting anything. Add optional Sheets sync when ready.
The current package is com.pocketledger.v6.preview. The staged APK uses the release build configuration with the existing signing certificate. It updates an existing installation signed with that certificate, and remains separate from the older release-signed Android app. Do not uninstall your only copy of the ledger to update.
For migration from the older app, export a JSON backup, keep that app installed, import into the current app, and verify balances/history. Device-specific configuration, including the Web App URL, must be reconnected. Separate bill-splitting data is not portable through the financial backup.
Skip this if you only want offline use.
- Copy Pocket Ledger — Android into your own Drive. The copy link is a template, not the app’s sync URL.
- In your Sheet’s desktop browser choose Extensions → Apps Script. Save the full Android script, also included as a website download.
- Deploy as a Web app, executing as yourself, with access set to Anyone for the chosen private-URL workflow. Complete Google’s authorization. For an existing deployment use Manage deployments → Edit → New version → Deploy; retain its existing
/execURL. - Run setupPocketLedger. For the clean layout, also run setupCleanTransactions after updating the deployment. Back up an existing workbook before migrating it.
- App → Settings → Sync & Sheets → Web App URL: paste the deployment URL ending in
/exec, then Test Connection → Sync Now → Refresh Sheet dashboard.
Keep the deployment URL private: anyone with it can call the Web app to access the synced ledger. This access model is different from sharing the Sheet template. The URL is deliberately excluded from JSON backups. Android cloud backups and device transfers also exclude the connection. Upgrading preserves the existing URL privately; restoring a phone requires reconnecting it.
The phone’s Room database stores entries first. With a URL configured, saving an entry can attempt sync; Sync Now manually sends the complete financial ledger, including accounts, payment routes, people and transaction/deletion records. The server merges stable IDs and timestamps. A new empty Sheet can receive previously synced records too. There is no scheduled background sync.
Failed requests retain local data for retry. Refresh Sheet dashboard rebuilds projections from the already-synced ledger; it does not upload the phone. Restore Data from Sheet merges the financial ledger into the phone and is not a substitute for preferences backup.
| Tab | Purpose |
|---|---|
| Transactions | Generated report of active entries, with consecutive Date, Month, Time, Category, Amount, Payment Mode, Account, Remarks, Type, Spending Type and Personal amount columns. Unclassified tags display blank. |
| Dashboard | Existing Canvas with period spending/income and current account/people snapshots. |
| Sync Support - Do not edit | Hidden original data sheet containing IDs, account/person snapshots, deletion markers and snapshot buffers. Its identity remains stable so Canvas retains its source. |
Edit entries in the app or Dashboard, not the generated report. Clearing report cells does not delete history; sync recreates the report. Do not delete hidden support storage. Canvas’s View data command may unhide that source; hide it again when finished. Repeated sync with the same IDs reuses rows; reinstalling and recreating accounts produces new IDs.
Use Clear transaction history in the app to clear financial entries. Accounts, payment links, opening balances, preferences and separate split bills remain. Balances return to opening amounts and people dues become zero. Set today’s actual opening balances afterward, then sync. Deletion markers prevent stale history from returning.
If Amount must be positive appears after manually clearing visible Sheet cells, update the backend/deployment: current code ignores metadata-only leftovers instead of treating them as zero-amount expenses. Active zero-amount expenses remain invalid. Uninstalling the app or deleting support data is not the repair.
If the Sheet is empty but phone balances are correct, use Sync Now, then Refresh Sheet dashboard. For a dashboard warning after successful sync, keep the local ledger and update the script before retrying the refresh. See backend setup.
Export Backup produces financial JSON containing accounts, payment routes, people, transactions and preferences, including theme/currency and category/payment configuration. Current exports use schema 3; older supported backups and earlier preview schema-4 financial data remain importable. Import merges stable records and preserves newer local data rather than blindly wiping the database.
The Web App URL, verified connection, sync timestamps and installation identifier are device-specific. Split bills and saved split friends are excluded. Export as Text is a readable copy, not a restorable backup. Keep financial backup files private and check an import before deleting the original.
Copy Pocket Ledger — iOS, use the supplied Shortcut, and follow the existing iOS setup PDF. The matching iOS script retains the original expense-to-Sheet workflow.
The native account ledger, offline Room storage, income/transfers, people settlements, widgets and standalone bill splitter described above belong to Android. Do not connect the iOS Shortcut to Android’s rich-ledger backend or use one platform’s setup guide as the other’s.
distribution/ is the current GitHub Pages website package. The restored neon-trace design uses locally hosted Lenis, GSAP and variable fonts. The homepage includes spending and feature highlights, a shared-payment example, a short data summary and direct Android/iOS downloads. Separate Features, Your data, Download and Guide pages hold detailed explanations, setup and FAQs. The original animated guide-book opens the current HTML guide. A Motion control complements device reduced-motion preferences. See design direction. The site describes the full Android ledger, separate iOS workflow, matching Sheet/script links, sync behavior and backup limits. The GitHub Pages workflow publishes distribution/ when main is updated.
The current illustrated Android PDF covers accounts, entries, Lena / Dena, item-level bill splitting, payments, OCR review, Sheets and backups. The guide hub links nine task chapters using real screenshots with demo data and editable native callouts. The earlier expense/widget PDF remains an archive. The iOS guide/Shortcut remain unchanged. website/experiments/v6/ is an older design experiment, not the current publication package.
| Location | Purpose |
|---|---|
V6/NativeExpenseEntry/ |
Current native Android Java/Room app and bundled backend |
V6/Backend/ |
Canonical Android Apps Script, maintained Canvas source and deployment notes |
V6/tests/ |
Money/ledger, backup, split/receipt, sync, Canvas and clean-Sheet regressions |
V6/docs/ |
Change-specific verification and implementation notes |
distribution/ |
Local website, staged downloads, platform scripts and existing PDFs |
tools/site-smoke/ |
Static content checks and optional browser smoke harness |
tools/guide/, V6/guide-captures/ |
Earlier guide authoring and private captures; guide work is deferred |
website/experiments/v6/ |
Historical design preview |
Install a compatible JDK (17+) and Android SDK API 36. Keep local paths/signing credentials outside committed files.
cd V6/NativeExpenseEntry
.\gradlew.bat :app:assembleDebug :app:lintDebug --offlineAPK output: V6/NativeExpenseEntry/app/build/outputs/apk/debug/app-debug.apk. For the protected signing backup, local release build, password-copy option and recovery steps, see release signing. Never store signing keys/passwords, personal deployment URLs or private captures in the website package.
From the repository root:
node V6/tests/needs-wants.test.cjs
node V6/tests/ledger-backend.test.cjs
node V6/tests/sheet-reports.test.cjs
node V6/tests/canvas-regressions.test.cjs
node V6/tests/clean-sheet-layout.test.cjs
.\V6\tests\run-ledger-tests.ps1
node tools/site-smoke/content-check.cjs
node tools/site-smoke/v6-publication.cjs --serveThe last command previews the actual website package at http://127.0.0.1:4829/Pocket-Ledger/. Browser verification uses the connected in-app browser; the preview server supports opt-in local axe diagnostics. The site has no build step; keyboard navigation, both themes and reduced-motion preferences are supported.
Source/local regression results do not establish every real-device interaction, receipt-recognition result or live Canvas rendering. Current backend/layout verification notes are in V6/docs/. GitHub Pages configuration points to distribution/, but publishing is a separate action.
Pocket Ledger's original code is licensed under the MIT License. Bundled third-party libraries and assets retain their respective licenses and notices.