StartRNR/INSTALL.md

41 lines
1.2 KiB
Markdown

# Installation
## Step 1: Authentication Token
In order to access start.gg's API, you must first have an authentication token
linked to your account. Instructions for generating one can be found in the
[developer API docs](https://developer.start.gg/docs/authentication).
Once you have an auth token, it must be provided to StartRNR. In order, the
program checks for a token in:
1. A command-line flag `--auth`.
2. An environment variable `AUTH_TOKEN`,
3. A file `auth.txt` within the config directory:
- Windows: `%APPDATA%\Roaming\startrnr/auth.txt`
- MacOS: `~/Library/Application Support/startrnr/auth.txt`
- Linux: `~/.config/startrnr/auth.txt`
The last method is recommended, as StartRNR can simply read from that file
whenever it needs to.
## Step 2: Dependencies
StartRNR requires these dependencies:
- [Rust](https://www.rust-lang.org/tools/install)
- [OpenSSL](https://github.com/openssl/openssl#build-and-install)
- [SQLite](https://www.sqlite.org/download.html)
Follow the instructions to download and install each.
## Step 3: Compiling
Once you have all the necessary dependencies, build and install StartRNR by
running the following command:
``` sh
cargo install --git https://github.com/kiana-S/StartRNR
```