Home

Awesome

tick-tock-tui

TICK TOCK NEXT ₿LOCK

TUI app to handle Bitcoin data provided by Mempool REST API incl. blocks, fees and price converter. Connect to your own Mempool instance if you like.

Preview

<a href="demo/tick-tock-demo.gif"> <img alt="preview" src="demo/tick-tock-demo.gif" /> </a>

Installation ⚙️

soon

Customize via arguments 🔧

tick-tock-tui --help

Usage: tick-tock-tui [-m|--mempool URL] [-r|--refresh SECONDS]
                     [-s|--storage DIRECTORY] [-i|--ignore]

  TUI app to handle Bitcoin data provided by Mempool: fees, blocks and price
  converter.

Available options:
  -m,--mempool URL         Mempool URL (default: "https://mempool.space")
  -r,--refresh SECONDS     Interval to auto-reload data in seconds
                           (default: 180)
  -s,--storage DIRECTORY   Folder to store application state
                           (default: "~/.local/state/tick-tock-tui")
  -i,--ignore              Ignore previous stored application state to use
                           default data instead.
  -h,--help                Show this help text

Local development

Requirements

Nix (recommended):

Install Nix. Enable flakes.

After that, cd into project directory to run nix develop. Check out available commands in a next chapter.

Others:

Following needs to be installed:

After installing everyting, check out available commands in next chapter.

Commands to build etc.

just --list

Available recipes:
    build              # build app
    format             # format files
    format-check       # check formats
    lint               # lint
    run                # run app
    run-custom url sec # run app with custom args (mempool url + seconds to refresh data)
    test               # run tests

FAQ

How to connect to a custom Mempool instance?

Start the app with -m parameter:

cabal run tick-tock-tui -- -m {custom-mempool-url}

Any data are stored locally?

Yes. To start the app with latest settings, some data (not all) of latest application state is stored locally. Locations to store data are following XdgState:

License

MIT License