Metadata-Version: 2.4
Name: varchive-client-linux
Version: 0.1.1
Summary: V-Archive client for linux
Author: Daniel Gu
Requires-Python: >=3.14
Description-Content-Type: text/markdown
Requires-Dist: marimo>=0.23.13
Requires-Dist: numpy>=2.5.0
Requires-Dist: pillow>=12.3.0
Requires-Dist: polars>=1.42.1
Requires-Dist: pytesseract>=0.3.13
Requires-Dist: requests>=2.34.2
Requires-Dist: watchdog>=6.0.0

# V-Archive linux client

> Disclaimer: this project is not affiliated with nor endorsed by the original creator of V-Archive.

Linux client for [https://v-archive.net/](https://v-archive.net/)

## Requirements

- [Tesseract](https://tesseract-ocr.github.io/tessdoc/Installation.html), including the Korean language pack (`tesseract-ocr-kor`)

## How to use

> NOTE: currently only song select and results screen screenshots in 1440p are supported.

- Install with `pip install varchive-client-linux`
- Download your account.txt file to: `~/.config/varchive_client/account.txt`
- To upload specific screenshot(s): `varchive_client screenshot1.jpg screenshot2.jpg ...`
- To automatically submit screenshots from Steam: `varchive_client --watch`

## Command-line arguments

```
usage: varchive_client [-h] [--account ACCOUNT] [--watch] [--watch-dir WATCH_DIR] [--ignore-cache] [--dry-run]
                       [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}]
                       [FILE ...]

Extract and submit DJMAX RESPECT V screenshots to v-archive.

positional arguments:
  FILE                  screenshot files to submit, or '-' to read file paths from stdin

options:
  -h, --help            show this help message and exit
  --account ACCOUNT     path to account.txt (default: /home/danielgu/.config/varchive_client/account.txt)
  --watch               watch and autosubmit files from the Steam screenshot library
  --watch-dir WATCH_DIR
                        watch and autosubmit files from a custom directory
  --ignore-cache, --ignore-cached-songs
                        ignore cached songs.json and fetch fresh song data
  --dry-run             detect scores without submitting them
  --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        logging verbosity (default: WARNING)
```
