add quickstart document (#216)
This commit is contained in:
parent
2d180f0209
commit
f080e35971
2 changed files with 59 additions and 0 deletions
|
@ -10,6 +10,10 @@ A command line utility for setting up and using Steam Mobile Authenticator (AKA
|
|||
# Disclaimer
|
||||
**This utility is effectively in beta. Use this software at your own risk. Make sure to back up your maFiles regularly, and make sure to actually write down your revocation code. If you lose both of these, we can't help you, your only recourse is to beg Steam support.**
|
||||
|
||||
# Quickstart
|
||||
|
||||
If you have no idea what the rest of this document is talking about, go read the [quickstart](docs/quickstart.md).
|
||||
|
||||
# Install
|
||||
|
||||
If you have the Rust toolchain installed:
|
||||
|
|
55
docs/quickstart.md
Normal file
55
docs/quickstart.md
Normal file
|
@ -0,0 +1,55 @@
|
|||
# Quickstart
|
||||
|
||||
steamguard-cli is a command-line tool, and as such, it is meant to be used in a terminal. This guide will show you how to get started with steamguard-cli.
|
||||
|
||||
## Windows
|
||||
|
||||
1. Download `steamguard.exe` from the [releases page](releases).
|
||||
2. Place `steamguard.exe` in a folder of your choice. For this example, we will use `%USERPROFILE%\Desktop`.
|
||||
3. Open Powershell or Command Prompt. The prompt should be at `%USERPROFILE%` (eg. `C:\Users\<username>`).
|
||||
4. Use `cd` to change directory into the folder where you placed `steamguard.exe`. For this example, it would be `cd Desktop`.
|
||||
5. You should now be able to run `steamguard.exe` by typing `.\steamguard.exe --help` and pressing enter.
|
||||
|
||||
## Linux
|
||||
|
||||
### Ubuntu/Debian
|
||||
|
||||
1. Download the `.deb` from the [releases page](releases).
|
||||
2. Open a terminal and run this to install it:
|
||||
```bash
|
||||
sudo dpkg -i ./steamguard-cli_<version>_amd64.deb
|
||||
```
|
||||
|
||||
### Other Linux
|
||||
|
||||
1. Download `steamguard` from the [releases page](releases)
|
||||
2. Make it executable, and move `steamguard` to `/usr/local/bin` or any other directory in your `$PATH`.
|
||||
```bash
|
||||
chmod +x ./steamguard
|
||||
sudo mv ./steamguard /usr/local/bin
|
||||
```
|
||||
3. You should now be able to run `steamguard` by typing `steamguard --help` and pressing enter.
|
||||
|
||||
# Importing existing maFiles from Steam Desktop Authenticator
|
||||
|
||||
If you have used [Steam Desktop Authenticator][SDA] before, you can use your existing maFiles into steamguard-cli, and they will be automatically upgraded for use with steamguard-cli.
|
||||
|
||||
1. Make a backup of your `maFiles` folder.
|
||||
2. Place your `maFiles` folder in the following directory:
|
||||
- Linux:
|
||||
- `~/.config/steamguard-cli/maFiles/`
|
||||
- Windows:
|
||||
- `%APPDATA%\Roaming\steamguard-cli\maFiles\`
|
||||
3. Run `steamguard` from your terminal.
|
||||
|
||||
|
||||
### Importing individual maFiles from Steam Desktop Authenticator
|
||||
|
||||
It's also possible to import a single maFile from Steam Desktop Authenticator and add it to your existing manifest.
|
||||
|
||||
```bash
|
||||
steamguard import --sda <path to maFile>
|
||||
```
|
||||
|
||||
[SDA]: https://github.com/Jessecar96/SteamDesktopAuthenticator
|
||||
[releases]: http://github.com/dyc3/steamguard-cli/releases
|
Loading…
Reference in a new issue