servicepoint-cli

This repository contains a command line interface for the ServicePoint display.

To send commands, this uses the servicepoint crate.

Installation with cargo

cargo install servicepoint-cli

If you have set your PATH to include the ~/.cargo/bin, you can now run servicepoint-cli.

Running with nix

# from CCCB Forgejo
nix run git+https://git.berlin.ccc.de/servicepoint/servicepoint-cli.git -- <args>

# from GitHub mirror
nix run github:kaesaecracker/servicepoint-cli -- <args>

Running a debug build

git clone https://git.berlin.ccc.de/servicepoint/servicepoint-cli.git
cd servicepoint-cli
cargo run -- <args>

Usage

Usage: servicepoint-cli [OPTIONS] <COMMAND>

Commands:
  reset-everything  [aliases: r]
  pixels            [aliases: p]
  brightness        [aliases: b]
  stream            [aliases: s]
  help              Print this message or the help of the given subcommand(s)

Options:
  -d, --destination <DESTINATION>  ip:port of the servicepoint display [default: 127.0.0.1:2342]
  -t, --transport <TRANSPORT>      protocol to use for communication with display [default: udp] [possible values: udp, web-socket, fake]
  -v, --verbose                    verbose logging
  -h, --help                       Print help
  -V, --version                    Print version

Stream

Usage: servicepoint-cli stream <COMMAND>

Commands:
  stdin   Pipe text to the display, example: `journalctl | servicepoint-cli stream stdin`
  screen  Stream the default source to the display. On Linux Wayland, this pops up a screen or window chooser, but it also may directly start streaming your main screen.
  help    Print this message or the help of the given subcommand(s)

Screen

Usage: servicepoint-cli stream screen [OPTIONS]

Options:
  -n, --no-dither  Disable dithering
  -p, --pointer    Show mouse pointer in video feed
  -h, --help       Print help

Stdin

Usage: servicepoint-cli stream stdin [OPTIONS]

Options:
  -s, --slow  
  -h, --help  Print help

Brightness

Usage: servicepoint-cli brightness <COMMAND>

Commands:
  max   Reset brightness to the default (max) level [aliases: r, reset]
  set   Set one brightness for the whole screen [aliases: s]
  min   Set brightness to lowest possible level.
  help  Print this message or the help of the given subcommand(s)

Pixels

Usage: servicepoint-cli pixels <COMMAND>

Commands:
  off     Reset all pixels to the default (off) state [aliases: r, reset]
  invert  Invert the state of all pixels [aliases: i]
  on      Set all pixels to the on state
  help    Print this message or the help of the given subcommand(s)

Contributing

If you have ideas on how to improve the code, add features or improve documentation feel free to open a pull request.

You think you found a bug? Please open an issue.

Submissions on Forgejo are preferred, but you can also use GitHub.

All creatures welcome.

License

This code is licensed under GNU General Public License v3.0 or later.