#Anybar

app anybar_rs

A Rust application for controlling Anybar

31 releases (10 stable)

1.0.12 May 22, 2019
1.0.11 Mar 4, 2018
1.0.7 May 5, 2017
1.0.4 Mar 12, 2017
0.9.4 Jun 12, 2015

#7 in macOS APIs

Download history 62/week @ 2019-11-27 33/week @ 2019-12-04 389/week @ 2019-12-11 32/week @ 2019-12-25 1/week @ 2020-01-01 62/week @ 2020-01-08 93/week @ 2020-01-15 1/week @ 2020-01-29 2/week @ 2020-02-05 35/week @ 2020-02-12 64/week @ 2020-02-19 64/week @ 2020-02-26 62/week @ 2020-03-04 32/week @ 2020-03-11

337 downloads per month

MIT license

7KB
53 lines

MIT Licensed

Description

anybar_rs is a command-line app for controlling the macOS Anybar application.

Installation

  • Download the latest 64-bit or 32-bit version here
    • unzip, then copy the binary into your $PATH (e.g. /usr/local/bin)
  • Alternatively:
    • install Rust and Cargo. Using rustup.rs is the easiest way to do this
    • run cargo install anybar_rs
  • The binary should now be available to use. To check, run anybar_rs --help.

Building from Source

  • Clone this project
  • Run cargo build --release from the project root
  • The binary will be available as target/release/anybar_rs
  • Copy it into your $PATH.

Usage

By default, anybar_rs assumes that Anybar is bound to localhost on UDP port 1738. Call it like so:
anybar_rs [FLAGS] [OPTIONS] <COMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information

OPTIONS:
-p, --port Set destination UDP port. Input must be 0 – 6553, and defaults to 1738

ARGS:
COMMAND The command you wish to send to Anybar

Where COMMAND is one of the following:

  • white
  • red
  • orange
  • yellow
  • green
  • cyan
  • blue
  • purple
  • black
  • question
  • exclamation
  • quit

Exit codes

Being a stateless protocol, UDP provides no mechanism for checking whether its datagrams arrive.

  • If the UDP datagram is succesfully sent, anybar_rs will exit with code 0.
  • Unknown flags, options, or an unknown command will print the usage and exit with code 1.

License

MIT

Dependencies

~765KB
~11K SLoC