update readme

This commit is contained in:
Carson McManus 2021-08-25 08:55:25 -04:00
parent c119484c1f
commit e5ee4b64de
2 changed files with 15 additions and 3 deletions

View file

@ -1,4 +1,7 @@
# steamguard-cli # steamguard-cli
[![Rust](https://github.com/dyc3/steamguard-cli/actions/workflows/rust.yml/badge.svg)](https://github.com/dyc3/steamguard-cli/actions/workflows/rust.yml)
A command line utility for setting up and using Steam Mobile Authenticator (AKA Steam 2FA). It can also be used to respond to trade and market confirmations. A command line utility for setting up and using Steam Mobile Authenticator (AKA Steam 2FA). It can also be used to respond to trade and market confirmations.
**The only legitamate place to download steamguard-cli binaries is through this repo's releases, or by any package manager that is linked in this document.** **The only legitamate place to download steamguard-cli binaries is through this repo's releases, or by any package manager that is linked in this document.**
@ -22,9 +25,11 @@ cargo +nightly build --release
``` ```
# Usage # Usage
`steamguard-cli` looks for your `maFiles` folder in the current user's home directory (eg. `~/maFiles/`). `steamguard-cli` looks for your `maFiles/manifest.json` in at these paths, in this order:
Your `maFiles` can be created with [Steam Desktop Authenticator][SDA]. You can create `maFiles` with - `~/.config/steamguard-cli/maFiles/`
steamguard-cli using the `setup` action (`steamguard setup`). - `~/maFiles/`
Your `maFiles` can be created with or imported from [Steam Desktop Authenticator][SDA]. You can create `maFiles` with steamguard-cli using the `setup` action (`steamguard setup`).
**REMEMBER TO MAKE BACKUPS OF YOUR `maFiles`, AND TO WRITE DOWN YOUR RECOVERY CODE!** **REMEMBER TO MAKE BACKUPS OF YOUR `maFiles`, AND TO WRITE DOWN YOUR RECOVERY CODE!**
@ -35,6 +40,10 @@ Full helptext can be displayed with:
steamguard --help steamguard --help
``` ```
## Importing 2FA Secret Into Other Applications
It's possible to import your 2FA secret into other applications, like Google Authenticator or KeeWeb. The `uri` field contains a URI in that starts with `otpauth://...`, which you can create a QR code for.
# Contributing # Contributing
By contributing code to this project, you give me and any future maintainers a non-exclusive transferable license to use that code for this project, including permission to modify, redistribute, and relicense it. By contributing code to this project, you give me and any future maintainers a non-exclusive transferable license to use that code for this project, including permission to modify, redistribute, and relicense it.

3
steamguard/README.md Normal file
View file

@ -0,0 +1,3 @@
# steamguard
The library used by steamguard-cli to all the steamguard related things, such as generating 2FA codes and responding to confirmations.