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.15.0.tar.gz (455.7 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.15.0-py3-none-any.whl (171.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kitsunekko_tools-26.5.15.0.tar.gz
  • Upload date:
  • Size: 455.7 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.15.0.tar.gz
Algorithm Hash digest
SHA256 e0337bc8720dc3d405cc70cb67861cb9ad2d721f4e183ee84dcaa028fce7ccb1
MD5 457b510b0f3a796dfafb6358ef2bdac1
BLAKE2b-256 a0673a1687b48d18d7faf40af8741ec2b84ca39869716c27646c56e36a8b2f33

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for kitsunekko_tools-26.5.15.0-py3-none-any.whl
Algorithm Hash digest
SHA256 779f5b61a8a48121648aaab0b0baa08667f7ac0902db8a70b0f2ae29b05b83ec
MD5 4420a0ca44fae7e988615be4e13ec7ad
BLAKE2b-256 f85a6cd8d075cc42e419cedc0dd849b03ee07b4bf5996e0dd9260a755baefa87

See more details on using hashes here.

Provenance

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