Skip to main content

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.

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.8.24.0.tar.gz (444.1 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.8.24.0-py3-none-any.whl (138.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kitsunekko_tools-26.8.24.0.tar.gz
  • Upload date:
  • Size: 444.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for kitsunekko_tools-26.8.24.0.tar.gz
Algorithm Hash digest
SHA256 192c121101eb92388fc1ae8a0d6557d11ffc9703c0003bef8013d579bd7ecca7
MD5 27f901ef19ed22e4081d338c81aaa139
BLAKE2b-256 d7d0066f53edaaf7bde0152d4dabe6cbffc6ab3d949c3e1edbd3157fea7841b5

See more details on using hashes here.

Provenance

The following attestation bundles were made for kitsunekko_tools-26.8.24.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.8.24.0-py3-none-any.whl.

File metadata

File hashes

Hashes for kitsunekko_tools-26.8.24.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4d8c303a3f35ebaf799bc01d322c87fe7ebe6d619e7db624cfd3677426dae7ae
MD5 30faf25d90b8ffdb83e6d77437864965
BLAKE2b-256 c57c9eaed88201ab84d39fb5dd0ab97f1ee286b0204d2ddddb8caec4f6f9bf1b

See more details on using hashes here.

Provenance

The following attestation bundles were made for kitsunekko_tools-26.8.24.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.

Release history Release notifications | RSS feed

This release

26.8.24.0 This release

2 files

26.7.11.0

2 files

26.6.15.0

2 files

26.5.24.0

2 files

26.5.15.0

2 files

26.5.13.0

2 files

26.4.13.0

2 files

26.3.26.0

2 files

26.1.26.0

2 files

26.1.25.1

2 files

26.1.25.0

2 files

26.1.24.1

2 files

26.1.24.0

2 files

26.1.11.0

2 files

26.1.7.0

2 files

26.1.6.1

2 files

26.1.6.0

2 files

26.1.4.1

2 files

26.1.4.0

2 files

26.1.3.0

2 files

25.5.1.0

2 files

24.12.10.1

2 files

24.12.10.0

2 files

24.11.28.2

2 files

24.6.7.0

2 files

24.6.5.0

2 files

24.5.26.0

2 files

24.5.3.1

2 files

24.5.3.0

2 files

24.4.30.0

2 files

24.4.29.0

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page