games-screenshot-manager/README.md

55 lines
2.4 KiB
Markdown
Raw Permalink Normal View History

2020-11-09 20:16:13 +00:00
# Games Screenshot Manager
A simple tool to collect and sort games screenshots from different platforms.
2020-11-19 22:18:01 +00:00
## Supported providers
2020-11-09 20:16:13 +00:00
2020-11-19 22:18:01 +00:00
Use the appropriate ID with the `-provider` flag. [See examples below](#Usage)
2021-02-16 12:30:25 +00:00
| Name | ID | Linux | Windows | macOS | Covers | Notes |
| ---- | -- | ----- | ------- | ----- | ------ | ----- |
| Steam | `steam` | Yes | Yes | Yes | Yes |
| Minecraft | `minecraft` | Yes | Yes | Yes | No |
| Nintendo Switch | `nintendo-switch` | - | - | - | No | Requires `-input-path` pointing to ALBUM folder
| PlayStation 4 | `playstation-4` | - | - | - | No | Requires `-input-path` pointing to PS4 folder
| RetroArch | `retroarch` | - | - | - | Yes | Requires `-input-path` pointing to Playlists folder
2020-11-09 20:16:13 +00:00
## How it works
2021-02-16 12:30:25 +00:00
Each provider has it's own way of finding the screenshots, but ideally the screenshots folder for games are known to us users so we only need to traverse them and find image files except for installations that may vary (like Retroarch) or systems outside of the PC ecosystem (Playstation, Nintendo Switch).
2020-11-09 20:16:13 +00:00
2021-02-16 12:30:25 +00:00
In some cases to have all the information for a particular provider we need to retrieve more data from the internet, for example the Steam game list to associate names to the IDs or in Nintendo Switch's case a community provided list to associate the internal ID with the Game's name.
2020-11-09 20:16:13 +00:00
For more details, you can check out [the source code for all providers](https://github.com/fmartingr/games-screenshot-manager/tree/master/pkg/providers)
2021-01-05 18:11:35 +00:00
Optionally a cover image for a game can be downloaded and placed under a `.cover` file in the game path. For this to work use the `-download-cover` flag. Check above for provider support for this feature.
2020-11-09 20:16:13 +00:00
## Installation
```
go get -u github.com/fmartingr/games-screenshot-manager
```
2021-02-16 12:30:25 +00:00
<!--
2020-11-09 20:16:13 +00:00
Or get a binary build from the [releases page](https://github.com/fmartingr/games-screenshot-manager/releases)
2021-02-16 12:30:25 +00:00
-->
2020-11-09 20:16:13 +00:00
## Usage
```
# Help
games-screenshot-manager -h
# Fetch and sort all Steam screenshots into ./Output
games-screenshot-manager -provider steam -output-path ./Output
2021-01-05 18:11:35 +00:00
# Like the one above but it'll download all header images for the games
games-screenshot-manager -provider steam -output-path ./Output -download-covers
2020-11-09 20:16:13 +00:00
# Perform a dry run (see what's gonna get copied where)
games-screenshot-mananger -provider steam -dry-run
2020-11-19 22:18:01 +00:00
# Parse all Nintendo Switch screenshots
games-screenshot-manager -provider nintendo-switch -input-path ./Album
2020-11-09 20:16:13 +00:00
```