USOS Discord Rich Presence

A simple C++ console executable which shows up as an activity in Discord when run. The activity contains information about current classes and/or lectures when linked to your USOS timetable.

Pre-built binaries

Full releases

Go to the latest GitHub release and there you will find executable files ready to be run, both for Windows and Linux.

To get help with the program's functionality, type the following command into your terminal:

$ usos-rpc --help

Development builds

Alternatively, if you want to try out the latest features, which might or might not even work, check out GitHub Actions. They are run for every new commit and contain artifacts with appropriate executables.

Building the project yourself

Dependencies to install before building:

• CMake ≥ 3.22
• Preferred build system, e.g. Ninja or GNU Make
• Preferred C/C++ compiler, e.g. GCC ≥ 13 or MSVC ≥ 17.2

First, clone the repository to your hard drive:

$ git clone /~https://github.com/Kacper0510/usos-rpc
$ cd usos-rpc

To prepare the build, run the following commands:

usos-rpc$ mkdir build
usos-rpc$ cd build
usos-rpc/build$ cmake ..

Then, run your build system, for example:

usos-rpc/build$ ninja usos-rpc
# ------------------- OR -------------------
usos-rpc/build$ cmake --build . -t usos-rpc

Finally, run the executable that was generated in the bin directory.