Yavook.de/fftcgtool
1
0
Fork 0
mirror of https://github.com/ldericher/fftcgtool synced 2025-01-15 15:02:59 +00:00
Code Issues Releases Wiki Activity

README for v2

Browse source
This commit is contained in:
Jörn-Michael Miehe 2021-08-23 17:21:07 +02:00
parent fc51a7de7a
commit 0b142c394f
1 changed files with 27 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
README.md
View file

@ -5,28 +5,43 @@ Card import tool for [Final Fantasy TCG Complete](https://steamcommunity.com/sha
## Usage
usage: main.py [-h] [-n COUNT] [OpusID]
```
usage: fftcgtool [-h] {opus,deck} ...
Imports FFTCG cards for TT-Sim.
Imports FFTCG cards for TT-Sim.
positional arguments:
OpusID the Opus to import
optional arguments:
optional arguments:
-h, --help show this help message and exit
-n COUNT, --num_threads COUNT
maximum number of concurrent requests
subcommands:
Import either an Opus to extend the mod, or import a deck to play right away.
{opus,deck} valid subcommands
```
### Run using your system's `python3`
1. Make sure `PIL` and `requests` python3 libraries (or equivalent) are installed.
1. Run `./main.py` from project root directory.
1. Make sure you have at least python version `3.9` installed.
To test, run `python --version` or similar.
Also, `pipenv` should be installed for that python version.
Refer to [pipenv installation guide](https://pipenv.pypa.io/en/latest/install/) if needed.
2. To install `fftcgtool` dependencies, run `pipenv install --deploy` from project root directory.
3. Run `pipenv run ./main.py` from project root directory.
4. You can `alias fftcgtool='PIPENV_PIPFILE="'$(pwd)'/Pipfile" pipenv run "'$(pwd)'/main.py"'` from
project root directory to define `fftcgtool` shorthand for your running shell.
### Run using a `docker` container
> Caveat: This simplistic container runs `fftcgtool` as root user.
> All generated files will thus be owned by `root:root` by default.
1. Make sure you have a working installation of `docker` software.
1. Update your local image `docker pull ldericher/fftcgtool`.
1. Run `docker run --rm -it -v "$(pwd)/out:/app/out" ldericher/fftcgtool` in any directory.
2. Update your local image .
- Either use `docker pull ldericher/fftcgtool`
- Or run `docker build --pull --tag ldericher/fftcgtool .`
3. Run `docker run --rm -it -v "$(pwd)/out:/app/out" ldericher/fftcgtool` in any directory.
4. You can `alias fftcgtool='docker run --rm -it -v "$(pwd)/out:/app/out" ldericher/fftcgtool'`
to define `fftcgtool` shorthand for your running shell.
Output files will go to subdirectory `./out`. CLI arguments are supported as `docker run --rm -it -v "$(pwd)/out:/app/out" ldericher/fftcgtool -n 2 5` (imports Opus 5 using 2 threads)