Skip to main content

A set of scripts for creating a local kitsunekko mirror.

Project description

kitsunekko-tools

PyPi Chat Support

A set of scripts for creating a local kitsunekko mirror.

The main benefit of having all subtitles saved locally is that you can browse them using lf and quickly search with fzf.

Install

Install using pipx from pypi.

pipx install kitsunekko-tools

The ktools executable will be available in your $PATH.

[!NOTE] On Windows-like systems, you may need to add the folder containing the ktools executable to your $PATH manually.

[!NOTE] If you don't have the required python version, install it first with hatch.

hatch python install 3.13
pipx install kitsunekko-tools --python ~/.local/share/hatch/pythons/3.13/python/bin/python

Configure

Run this command to create the config file.

ktools config create

Edit the config file.

  • destination - the local folder where the files should be downloaded.
  • proxy - Your proxy settings. Set to "" (empty string) if you don't use proxies. By default, it is set to the default Tor address.

Everything else usually doesn't need to be changed.

Usage

[!TIP] Clone kitsunekko-mirror before downloading from kitsunekko directly.

The first time, run full sync. It will download everything.

ktools sync --full

Run sync. If you already have downloaded everything once, this command will skip files that have not been modified recently.

ktools sync

The skip_older config parameter controls what files should be skipped during regular runs.

Upload your mirror to Mega

  1. Install megatools.
  2. Create ~/.megarc and specify your credentials.
  3. Run ktools upload.

Ignoring certain files

To prevent some files from being downloaded (because they are too big, broken, etc.), Create a file named .kitsuignore in the root of destination and fill it with paths relative to destination.

Help

Run ktools --help to print a help page.

Environment variables

  • KITSU_API_KEY - overwrite api_key in the config.
  • KITSU_API_URL - overwrite api_url in the config.

Kitsunekko mirror

kitsunekko-mirror is a git repository with Japanese anime subtitles.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kitsunekko_tools-26.5.13.0.tar.gz (461.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kitsunekko_tools-26.5.13.0-py3-none-any.whl (171.3 kB view details)

Uploaded Python 3

File details

Details for the file kitsunekko_tools-26.5.13.0.tar.gz.

File metadata

  • Download URL: kitsunekko_tools-26.5.13.0.tar.gz
  • Upload date:
  • Size: 461.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kitsunekko_tools-26.5.13.0.tar.gz
Algorithm Hash digest
SHA256 060c6bc056fdc28fbc8888c4941c27dcdb748b855d037b245642bcf941ae0e41
MD5 ceb882352700fd09c34eff23047147b8
BLAKE2b-256 9f5dd3d0f0575db389c553038baaa05ea33540f05f9daa453d1b24c12b21b79a

See more details on using hashes here.

Provenance

The following attestation bundles were made for kitsunekko_tools-26.5.13.0.tar.gz:

Publisher: ci-cd.yml on Ajatt-Tools/kitsunekko-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file kitsunekko_tools-26.5.13.0-py3-none-any.whl.

File metadata

File hashes

Hashes for kitsunekko_tools-26.5.13.0-py3-none-any.whl
Algorithm Hash digest
SHA256 13e751d0bc2eeac68b94ae70b0f88bddd6b357e27fb55b3ff5f1844241f9c53c
MD5 77b2e9807612a64c4a3de48df8070b52
BLAKE2b-256 14160eac11d1cc60d31313bceec322d02b433d2432ca63e0bc1b192e83f8fb59

See more details on using hashes here.

Provenance

The following attestation bundles were made for kitsunekko_tools-26.5.13.0-py3-none-any.whl:

Publisher: ci-cd.yml on Ajatt-Tools/kitsunekko-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page