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.6.15.0.tar.gz (424.9 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.6.15.0-py3-none-any.whl (118.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kitsunekko_tools-26.6.15.0.tar.gz
  • Upload date:
  • Size: 424.9 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.6.15.0.tar.gz
Algorithm Hash digest
SHA256 2ea501e4873eb70f4b5cd43819c3946606031bb120c42ce3d261ce2702097768
MD5 ef78e2f573f5b6844ee6f8002727c775
BLAKE2b-256 6286e2da3fa5451b963b09579f2b3324bbeb53916538be8b8ab644dab6b67e1e

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for kitsunekko_tools-26.6.15.0-py3-none-any.whl
Algorithm Hash digest
SHA256 12f74e1f7389c1691722ee0b595aae0460c10d7103736e599f21f8f3d723d438
MD5 463b83ff8946347e47b9d89f120cae96
BLAKE2b-256 9b8f7b830d61eb325c2454b7c353e1828fdd075404050cf4332eb05c57f2dd8d

See more details on using hashes here.

Provenance

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