This is an alternative, cross-platform terminal client to the planning poker server provided by pp. It's designed to be used with a keyboard only, without relying on a mouse for input. The user interface is highly opinionated and probably not suited for everyone, relying heavily on keyboard shortcuts.
Download the current version for your operating system from the release page or use the following direct links:
./ppoker <roomname>That's it.
The name of a room is optional, if omitted a room is generated automatically.
Client for planning poker - https://github.com/sne11ius/pp
Usage: ppoker [OPTIONS] [ROOM]
Arguments:
[ROOM] Room to join
Options:
-n, --name <NAME> Name to use for this session
-s, --server <SERVER> Websocket URL to connect to
-A, --disable-auto-reveal Disables automatic reveal of cards
-S, --skip-update-check Skip the automatic update check and stay on the current version
-N, --disable-notifications Disable notifications
-h, --help Print help
-V, --version Print version
You can also use environment variables to set each argument or option. For this prefix the option name with
PPOKER_. For example: PPOKER_ROOM=planning-room ./ppoker
You can set defaults for the commandline arguments by providing a config file in .toml format at the following
location:
| Platform | Value |
|---|---|
| Linux | $XDG_CONFIG_HOME/ppoker/config.toml or $HOME/.config/ppoker/config.toml |
| macOS | $HOME/Library/Application Support/dev.jko-ppoker/config.toml |
| Windows | %APPDATA%\ppoker\config\config.toml |
Create a config.toml with any of the following keys:
name = "ja-ko"
room = "planning-room"
server = "wss://pp.discordia.network/"
disable_auto_reveal = false
skip_update_check = false
disable_notifications = false
keep_backup_on_update = true
always_update = false