Repository navigation
Releases
Tally v0.7
Tally keeps a running tally of your tasks, in a window or in a terminal.
Download tally.jar below, put it in a folder of its own, and run it:
java -jar "tally.jar"Requires Java 25. Your tasks are kept in data/tally.txt beside the jar.
What is new since v0.6
An event can carry the hours it runs between. A time may follow either end's
date, written on a 24-hour clock as HH:mm and shown back on a clock face:
event CS2103T lecture /from 2026-09-12 16:00 /to 2026-09-12 18:00
[E][ ] CS2103T lecture (from: Sep 12 2026 4:00 pm to: Sep 12 2026 6:00 pm)
Leave the time off and Tally takes the whole day: as a start, from the moment the
day begins, and as an end, until it is over. So an event from 2026-09-11 20:00
to 2026-09-11 runs from eight in the evening to midnight, and is not back to
front. Every event written before this keeps working, and is still written the
same way.
Two ends on one day can now be told apart, so an afternoon running back to the
morning is refused where it used to be recorded exactly as typed.
Smaller corrections
- An event ending at
00:00leaves that day free. Midnight closes the day before
it rather than opening the one it names, and with no24:00to write instead,
00:00is the only way to say it. - A start written
2026-09-08and one written2026-09-08 00:00are two
spellings of one moment, so the second is no longer added beside the first.
171 unit tests and 46 whole-program console sessions run on Ubuntu, Windows and
macOS on every push, along with a check that this jar opens its window.
Known limitation
The JavaFX libraries in this jar are built for Intel macs. On an Apple Silicon
mac the window will not open unless an x86 Java is used. Linux and Windows are
unaffected.
Tally v0.6
Tally keeps a running tally of your tasks, in a window or in a terminal.
Download tally.jar below, put it in a folder of its own, and run it:
java -jar "tally.jar"Requires Java 25. Your tasks are kept in data/tally.txt beside the jar.
What is new since v0.5
An event's two ends are now dates, in the same yyyy-mm-dd form a deadline
takes. They used to be kept as whatever you typed, so Mon 2pm was taken, and
so was y, and so was 2026-02-30, which was shown back to you as though
February had thirty days while a deadline written the same way was refused.
Because every event now names days that can be read, the free-day search sees
the whole tally, and the sentence it used to add to own up to counting less
than that is gone.
Upgrading from v0.5 or earlier
A data file written by an earlier version can hold an event whose ends are not
dates, such as E | 0 | meeting | Mon 2pm | 4pm. Tally names those lines,
copies the file to tally.txt.broken for repair and leaves the tasks off the
tally, as it does for any line it cannot read. Add them again as dates.
159 unit tests and 42 whole-program console sessions run on Ubuntu, Windows and
macOS on every push, along with a check that this jar opens its window.
Known limitation
The JavaFX libraries in this jar are built for Intel macs. On an Apple Silicon
mac the window will not open unless an x86 Java is used. Linux and Windows are
unaffected.
Tally v0.5
Tally keeps a running tally of your tasks, in a window or in a terminal.
Download tally.jar below, put it in a folder of its own, and run it:
java -jar "tally.jar"Requires Java 25. Your tasks are kept in data/tally.txt beside the jar.
What is new since v0.4
Nothing you type behaves differently, with one exception: saying bye a
second time is answered a second time, where it used to pass in silence.
The rest is tidying, done in response to a review of the code:
- The chatbot and the storage were split into smaller classes, each with one
job, and the notes about a damaged data file are put together without nesting. - A failure reading or writing the file now carries what the file system said,
so a problem can be traced rather than guessed at. - The window scrolls to whatever the pane calls its foot, rather than to a
number that only happens to be that today.
161 unit tests and 40 whole-program console sessions run on Ubuntu, Windows and
macOS on every push, along with a check that this jar opens its window.
Known limitation
The JavaFX libraries in this jar are built for Intel macs. On an Apple Silicon
mac the window will not open unless an x86 Java is used. Linux and Windows are
unaffected.
Tally v0.4
Tally keeps a running tally of your tasks, in a window or in a terminal.
Download tally.jar below, put it in a folder of its own, and run it:
java -jar "tally.jar"Requires Java 25. Your tasks are kept in data/tally.txt beside the jar.
What is new since v0.3
- A tab does what a space does. A command typed with a tab after it was
refused as a command nobody knows, while the same tab inside a description was
tidied to a space. Both are read the same way now. - A hand-edited file is held to the rules the keyboard is held to. A saved
file can no longer slip past a duplicate, an event whose dated ends run
backwards, or a date padded with spaces that was shown but not counted. - Failures keep their cause. What the file system said is carried along with
the sentence written for you, so a problem can be traced rather than guessed
at.
Inside, the storage and the chatbot were split into smaller classes, each with
one job. Nothing about that changes what the program does.
160 unit tests and 40 whole-program console sessions run on Ubuntu, Windows and
macOS on every push, along with a check that this jar opens its window.
Known limitation
The JavaFX libraries in this jar are built for Intel macs. On an Apple Silicon
mac the window will not open unless an x86 Java is used. Linux and Windows are
unaffected.
Tally v0.3
Tally keeps a running tally of your tasks, in a window or in a terminal.
Download tally.jar below, put it in a folder of its own, and run it:
java -jar "tally.jar"Requires Java 25. Your tasks are kept in data/tally.txt beside the jar.
What is new since v0.2
- A voice of its own. Every reply is written in one register, dry and
unsparing, down to the refusals and the complaints about the data file. - A window worth looking at. Laid out rather than anchored, so it grows with
the window; redrawn portraits; a palette that is not the default grey. - Errors it names rather than acts on.
bye nowno longer ends the session
silently, a marker given twice is refused rather than swallowed, and the same
task cannot be added twice. - A data file it treats as carefully as a command. A file edited by hand can
no longer slip a duplicate, a backwards-dated event, or a stray byte-order
mark past the rules the keyboard enforces.
156 unit tests and 39 whole-program console sessions run on Ubuntu, Windows and
macOS on every push, along with a check that this jar opens its window.
Known limitation
The JavaFX libraries in this jar are built for Intel macs. On an Apple Silicon
mac the window will not open unless an x86 Java is used. Linux and Windows are
unaffected.
Tally v0.2
Tally now has a window, so it is no longer confined to a terminal.
The jar of v0.1 predates the GUI and bundled JavaFX for Linux only,
which meant it would not start on Windows or macOS. This one bundles
all three platforms.
What changed since v0.1
- A JavaFX window, with the conversation scrolling as it grows (
Level-10) - Find tasks by a word in their description (
Level-9) - Add several tasks in one call (
A-Varargs) - Checkstyle wired into the build, so a style violation fails it (
A-CheckStyle) - Javadoc across the packages, and naming fixes raised in peer review
Running it
java -jar tally.jar
Requires Java 25. Tasks are kept in data/tally.txt beside the jar.
Tally v0.1
Tally is a command-line chatbot that helps you keep a tally of your tasks.
Running it
Download tally.jar, put it in a folder of its own, and run:
java -jar "tally.jar"
Requires Java 25. Your tasks are saved to data/tally.txt beside the jar, and
read back the next time you start it.
Commands
| Command | What it does |
|---|---|
todo read book |
Add a task with no date |
deadline return book /by 2019-10-15 |
Add a task due on a date |
event project meeting /from Mon 2pm /to 4pm |
Add a task that runs between two times |
list |
Show everything on the tally |
mark 2 / unmark 2 |
Tick a task off, or put it back |
delete 2 |
Remove a task |
bye |
Leave |