Soloterm

What Is It?

Soloterm is an application you run in the terminal (mac, windows, linux) to log your solo TTRPG sessions. Being a terminal based app, it has fast keyboard navigation. 

You own the data. It's all right on your computer. No internet required. No account required.

What Can It Do?

Track Games

You create a game and track multiple sessions within the game.  Games are just a name for adding session logs to. You'll need to add a game before adding logs.

Once you have a game setup, you can start adding session logs.

Log Sessions

Session logging is done via a simple text editor. The editor provides:

• Autosaving changes as you go
• No formatting is displayed, however, you can enter formatting (like markdown)
• Import/Export a session

Lonelog Tags 

Lonelog is a syntax for session logging. It's great. Go check it out. I've added Lonelog support to session logging via tags.

• Insert tag templates, then fill out
• Insert a core log (Character Action, Oracle Question, Dice) template, then fill it out
• It tracks "open" tags so when you open the tag modal, the most recent open tag appears for quick entry.
• You can customize the tag templates by editing the config.yaml file created when the application starts. Press F1 to find the config file.

Game Notes

Separate from session logs is game notes. Notes are intended to live beyond a single session. Things like the adventure hook, key NPCs, and location descriptions could go here. Any tags added here appear in the tag modal under a Notes Tags section.

Searching

You can quickly search session logs and notes for details. A snippet of the content is provided for context and the words you searched for are highlighted in yellow. Picking the result will jump you straight to the proper location in the session or note. 

Random Tables

You can add random tables to the application which are then integrated into the dice roller allowing quick and easy random generation for the session log.

Dice Rolling

There's a flexible dice roller that allows you to quickly enter a standard dice notation (1d6, 2d6kh1, etc.) and get a result. You can enter multiple rolls and get the results in one key press. Once you have the result, you can insert it directly into the log.

You can also select from a list of entries, or roll on a random table.

Snippets allow you to save frequently used dice rolls, table references, and expressions for quick reuse directly from the dice roller.

Simple Character Sheets

Once you've added a character, you can edit their character sheet to add entries and their values. It's simple by design, but flexible enough to track things that you reference the most.

Where Do I Get It?

The code and application are released under the MIT license. You can access both on Github.

If you find issues, have suggestions for changes, or want to submit a change you've made, please do so through Github.

uname -m

./soloterm_linux