gog-sync/README.md

111 lines
2.8 KiB
Markdown
Raw Normal View History

2017-03-20 18:00:27 +00:00
# GOG-SYNC
2017-03-22 14:39:46 +00:00
## **Please note that this is alpha software, you should not trust it.**
2017-03-20 18:00:27 +00:00
A small tool to synchronize the stuff in a [GOG](https://www.gog.com/) library
2017-03-20 18:00:27 +00:00
with a local folder.
It builds on the work of the [unofficial GOG API Documentation](https://gogapidocs.readthedocs.io/en/latest/).
This is the first time I am building something with rust, so beware :)
2017-03-21 16:29:44 +00:00
# Installation
2017-03-24 08:48:29 +00:00
Install from [crates.io](https://crates.io/crates/gog-sync).
2017-03-21 16:29:44 +00:00
```
cargo install gog-sync
```
2017-03-20 18:00:27 +00:00
# Configuration
The configuration file is in the config folder as described by the xdg specification
with a prefix of `gog-sync`.
For example on macOS or Linux
```
~/.config/gog-sync/config.json
```
2017-03-22 14:39:46 +00:00
A bare configuration with default values before first use:
2017-03-22 14:39:46 +00:00
```
{
"gameStorage": ".",
"movieStorage": ".",
"osFilters": [],
"languageFilters": [],
2017-05-10 13:00:28 +00:00
"resolutionFilters": [],
2017-03-22 14:39:46 +00:00
"skipMovies": false,
"skipGames": false
}
```
- *gameStorage*: Where to save games
- *movieStorage*: Where to save movies
- *osFilters*: An array of operating systems. If it is not empty, game data is limited to the ones in the list.
- *languageFilters*: An array of languages. If it is not empty, game data is limited to the ones in the list.
2017-03-22 15:11:28 +00:00
- *resolutionFilters*: An array of resolutions. If it is not empty, movie data is limited to the ones in the list.
2017-03-22 14:39:46 +00:00
- *skipMovies*: Whether to skip movie content
- *skipGames*: Whether to skip game content
2017-03-22 15:11:28 +00:00
Valid values for *osFilter*:
- `linux`
- `mac`
- `windows`
2017-03-22 16:37:44 +00:00
Check on [gog.com](https://www.gog.com/) which languages are available.
2017-03-22 14:39:46 +00:00
2017-03-22 15:11:28 +00:00
An incomplete list of resolutions on gog:
- `DVD`
- `576p`
- `720p`
- `1080p`
- `4k`
2017-03-20 18:00:27 +00:00
# Usage
If you want to see the information log while running set `RUST_LOG=info`.
2017-03-22 14:39:46 +00:00
```
2017-03-22 15:11:28 +00:00
USAGE:
gog-sync [FLAGS] [OPTIONS]
2017-03-22 14:39:46 +00:00
FLAGS:
-h, --help Prints help information
-g, --skip-games Skip game content.
-f, --skip-movies Skip movie content.
-V, --version Prints version information
OPTIONS:
-s, --game-storage <FOLDER> Sets the download folder (defaults to the working directory).
-l, --language <FILTER> Only sync files for this comma seperated list of languages.
-m, --movie-storage <FOLDER> Sets the download folder for movies (defaults to the working directory).
-o, --os <FILTER> Only sync files for this comma seperated list of operating systems.
Valid values are 'linux', 'mac' and 'windows'.
2017-03-22 15:11:28 +00:00
-r, --resolution <FILTER> Only sync movies for this comma seperated list of resolutions.
2017-03-22 14:39:46 +00:00
```
---
2017-03-20 18:00:27 +00:00
```
gog-sync
```
Normal invocation, uses the current working directory as storage if not configured
otherwise.
---
2017-03-20 18:00:27 +00:00
```
gog-sync -s ~/Downloads/games
```
Overwrite the default or configured storage path.
---
```
gog-sync -l english -o linux,windows
```
Only sync english installers and only for linux and windows systems.