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.24.0.tar.gz (424.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.24.0-py3-none-any.whl (118.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kitsunekko_tools-26.5.24.0.tar.gz
  • Upload date:
  • Size: 424.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.24.0.tar.gz
Algorithm Hash digest
SHA256 7ea64b88ab67beda799fd8747c0c098bb4c8ddd611502123431e34f20d2e62d0
MD5 7e060bcb34a15b8c70d4f2e67bfd0f77
BLAKE2b-256 9be9e9cf34206886bf1ed72e269515b0b01013425bb305c07a430010a4e7b1c2

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for kitsunekko_tools-26.5.24.0-py3-none-any.whl
Algorithm Hash digest
SHA256 063369714dbc011214006c991bcf9a1b51c4feb0e2e5ab39c51438eafbbc13e4
MD5 9ea288d66839ce52639cf4cf64075653
BLAKE2b-256 8d3931f87ab8723d33582e221de4cbec2d5ae7d2c914de21d9ad99acb8aca6d7

See more details on using hashes here.

Provenance

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

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