Toxuki/kioku
1
0
Fork 0
Code Issues Pull requests Projects Releases 233 Packages Wiki Activity Actions
233 releases 235 tags
  • v1.4.0 3705cd226e

    Kioku 1.4.0
    Some checks failed
    release / release (push) Has been cancelled
    Details
    Stable

    Toxuki released this 2026-10-15 22:00:47 +00:00 | 1455 commits to main since this release

    Kioku is a tracker for anime, manga and light novels that runs on your own computer. It is made first for Windows and works on macOS and Linux too. Your library lives in a database on your computer, syncs with AniList, MyAnimeList, AniDB, Kitsu and MangaBaka, plays your episodes in mpv or follows the player you already use, reads your manga and light novels, and lets you watch together with friends. Kioku speaks English and Slovak.

    New in 1.4.0

    • Kioku accounts: Kioku now has a server of its own, at kioku.toxik.space. Sync > Kioku logs in to an account there, or creates one with an email and an invite code from a friend, and keeps your library on the server in step with the app: every title, the ones you added yourself included. A second computer that logs in gets the whole library, and AniList, MyAnimeList and the rest keep syncing beside it.
    • The web version: the server's address opens Kioku in any browser or phone. Log in to see your library by kind and status, add an episode with one click, change status, score, dates, notes and tags, make invite codes for friends, and see which devices are signed in.
    • Joining is by invite at first: everyone on the server can hand out a few codes, and the people who run it can open sign-up to everyone later.
    • For whoever runs the server: the release carries Kioku-server-1.4.0-linux-x64.tar.gz (and arm64) with the server, a container recipe and podman units for systemd, PostgreSQL included, with nightly database backups. The guide inside walks through it; the first account becomes the admin with the setup code the server prints.

    New in 1.3.2

    • Fixed: on some computers every change in Settings failed with "language lists are codes separated by commas", and notifications could not be turned on. Kioku now resets a stored setting it cannot accept to its default instead of refusing every later change, and accepts audio and subtitle languages written with spaces ("ja, jpn") or with regions such as es-419.

    New in 1.3.1

    • Fixed: on Linux and macOS, stopping Kioku from the terminal it was started in (Ctrl+C) or with a signal left its window open on a page that no longer answered. The window now closes with Kioku.

    New in 1.3.0

    • Your own player counts: Kioku now sees which episode VLC, MPC-HC, MPC-BE, PotPlayer, SMPlayer, KMPlayer, GOM Player, mpv, mpv.net or the Media Player app has open on Windows, and every MPRIS player plus the window titles on Hyprland, Sway and i3 on Linux. It finds the title in your library and marks the next episode watched once most of it played, with Undo in the toast. A bar under the page shows what it recognised; an episode further ahead waits for Mark watched, and a file it cannot place offers Choose title, which Kioku remembers for every file with that name. Turn it off under Settings > Player and files.
    • Play files in your default player: Settings > Player and files > Play files in > Default player opens episodes in whatever program your system opens videos with, so Play works without mpv, and Kioku follows that player as above.
    • The Discord status shows episodes from other players too, with the time left when the player tells it.
    • Home suggests what to watch and read next: Next in the series lists sequels of what you finished that are not in your library yet, and Recommended for you collects what AniList's users recommend next to your best-rated titles. Wave away what you do not want and it stays away.
    • Kioku tells you when a sequel of a title you finished or are watching is announced or comes out (Settings > Notifications > Sequels).
    • Tags: Search can require or leave out any of AniList's tags (Isekai, Time Skip, Female Protagonist and hundreds more), a title's page lists its tags with spoilers hidden until clicked, and the library filters have a Tags section. Kioku reads the full AniList record of every title in your library in the background, so tags, descriptions and related titles are there for lists brought in from elsewhere too.
    • Stats has Your year: titles finished per kind and month, time watched, mean score, top genres, tags and studios, the highest rated and the longest, for any year.
    • Compare with a friend: open someone you follow on AniList under Friends to see your taste match from the scores you both gave, their favourites you have not seen, yours they have not, the titles you both love and where you disagree most.
    • Backups: Kioku now also backs up once a day when the library changed, and Keep copies in (Settings > Data) copies every backup to a folder of your choice, such as one OneDrive, Google Drive or Dropbox keeps safe.
    • Updates list what every release since yours brought, not only the newest.

    New in 1.2.0

    • Characters, staff and studios: three new pages in the sidebar keep your favourite characters, people (voice actors, directors, authors) and studios. Their own pages show who they are, AniList's description with spoilers hidden until clicked, and their works: where a character appears and who voices them, a voice actor's roles and other credits, a studio's works. Press the heart on their pages, in Search or on a title's page; with AniList connected, Import from AniList brings in your favourites from there.
    • Search finds characters, staff and studios too, and Source now lists every service Kioku is set up for: MyAnimeList and AniDB join Kitsu and MangaBaka.
    • Where to watch says where each link works when its address or AniList's note tells (Japan, United States, Southeast Asia and so on) and marks links meant for other regions than the one set in Settings.
    • Images load much faster: a cover Kioku has not kept yet comes straight from its image server, alongside the rest of the page, while Kioku keeps a copy for next time. With nothing kept yet, the first screen of the library loads in under a second instead of three, the seasons page instead of seven.
    • Fixed: MyAnimeList got the same progress on every sync for titles where Kioku counts more episodes or chapters than MyAnimeList's record of the work.
    • Fixed: kioku version prints the version; it used to start the app.

    New in 1.1.1

    • Linux with NVIDIA graphics: Kioku now opens in an app window of Chromium, Chrome, Brave, Vivaldi or Edge when one is installed, instead of WebKitGTK. WebKitGTK crashed on NVIDIA's driver, and drawing without the GPU made it lag; the browser window draws with the GPU, smoothly. KIOKU_WINDOW=native keeps WebKitGTK.
    • When Kioku crashes, the details are written at the end of kioku.log in the data folder (Settings > App shows the folder), so a crash can be reported and fixed. On Linux the system's crash reporter also keeps a core dump.

    New in 1.1.0

    • Kitsu: connect with your Kitsu email or profile name and your password. The password goes to Kitsu once, for a login token, and is not kept. Anime, manga and light novels sync both ways, with Kitsu's scores of 1 to 10 in half steps.
    • MangaBaka: connect with an API key from your MangaBaka account settings. Manga, manhwa, manhua and light novels sync both ways, chapters and volumes included.
    • Search can ask Kitsu or MangaBaka instead of AniList (Source next to the tabs), for the titles AniList does not have, and add them in one click.
    • Titles from Kitsu and MangaBaka join the same works as on AniList and MyAnimeList through the IDs they carry, so nothing shows up twice.
    • Connecting another service never overwrites what it has with empty values: the first time an entry meets a service, a filled-in note, date, score or volume count wins on either side.
    • Login errors say what was wrong: an empty field, or details the service did not accept.

    Download and first start

    System File First start
    Windows 10 and 11 Kioku-1.4.0-windows.zip Unzip it and double-click Kioku.exe. Kioku is not code signed, so Windows may say "Windows protected your PC": click More info, then Run anyway. Kioku adds itself to the Start menu.
    macOS 12 and later Kioku-1.4.0-macos.zip Move Kioku to Applications and open it. It is not notarized, so the first time open System Settings > Privacy & Security and click Open Anyway.
    Linux x64 and arm64 Kioku-1.4.0-linux-x64.tar.gz, Kioku-1.4.0-linux-arm64.tar.gz Extract and run ./kioku. Kioku adds itself to the application menu.

    SHA256SUMS lists the checksums of every file. Kioku opens in a window of its own (WebView2 on Windows; on Linux WebKitGTK, or a Chromium-based browser's app window with NVIDIA graphics or without WebKitGTK; the default browser as a last resort). To connect AniList, open Sync, choose Connect next to AniList and approve: nothing else to set up. The first sync is always a preview that changes nothing until you apply it.

    To play episodes in Kioku's own player, install mpv; or keep the player you have and let Kioku follow it. Everything else Kioku needs comes with it or installs itself.

    What Kioku does

    Home and your library

    • Home shows what to watch and read next: the next episode or chapter of everything in progress, with Play or Read when the file is on your computer and Watch on your streaming service otherwise, what airs this week from your list, first episodes further out, sequels of what you finished, recommendations from your best-rated titles, a random pick from Planning, and finished titles still waiting for a score.
    • Library, Anime, Manga and Light novels show your entries as covers, a list or a table, with status tabs, filters (format, genre, tag, year, season, score, provider links, airing, my streaming services), saved presets and sorting.
    • Quick edits everywhere: +1, status and score menus, a full editor with a date picker for started and finished dates and a tag picker. Your own tags can be renamed, merged, coloured and deleted in Settings.
    • Select several titles to change their status, score or tags, put them on a list or remove them at once; removing asks first and can be undone.
    • The keyboard works throughout: Ctrl+K opens the command palette, / filters, j and k move, + and - change progress, 1 to 9 score, ? lists the keys.
    • Titles of your own that no provider knows can be added by hand.

    Finding titles

    • Search covers all of AniList's anime, manga and light novels: type a name or browse what is trending, with filters for format, status, season, year, genres and tags and five ways to sort. Characters, Staff and Studios search AniList's people. Source switches to another service Kioku is set up for (MyAnimeList, AniDB, Kitsu, MangaBaka), searched by title. One click adds a title.
    • A title's page has your entry, where to watch, the airing schedule, its tags, characters with their voice actors, staff, recommendations, related titles and the trailer, plus what your friends think of it. Arrange sections chooses what shows and in what order.

    Syncing

    • Two-way sync with AniList, MyAnimeList, AniDB, Kitsu and MangaBaka, field by field against what each service last confirmed, so changes on both sides merge instead of overwriting each other.
    • Every first sync is a preview. Conflicts wait for you to choose, and nothing is ever deleted on a service without your confirmation.
    • MyAnimeList XML exports can be imported without an account, and the library exported in that format.
    • Titles are linked across services with the anime-offline-database, the IDs Kitsu and MangaBaka give, and title matching; uncertain links wait for review.

    Watching

    • Add the folders with your episodes in Settings > Player and files. Kioku reads the file names, links the files to your titles and lists them on each title's page; files it cannot place wait for you to assign.
    • Episodes play in mpv with the following ones queued, resume where you stopped, are marked watched near their end, and openings and endings are skipped from chapters and AniSkip, on their own or with Tab. A bar under every page shows what plays and controls it.
    • Or watch in the player you like: Kioku follows VLC, MPC-HC, PotPlayer and the others, and Play can open files there.
    • Free official streams (YouTube, Bilibili) and trailers play in mpv through yt-dlp, which Kioku installs, checks and keeps up to date along with Deno.
    • Where to watch lists the streaming services of each title, your services first, with the region a link is meant for when Kioku can tell; Watch opens the episode and Kioku offers to mark it watched when you come back.
    • Discord can show what you watch as your status (Settings > Player and files). It needs a Discord application ID, which Settings explains how to make.

    Reading

    • Manga, comics and light novels in the same folders open in Kioku's reader: CBZ, ZIP, CBR and RAR archives, folders of images, PDFs and EPUBs.
    • Right to left, left to right, two pages at a time or a long strip, remembered per title; EPUBs follow the app's colours with a text size of your choice.
    • Kioku remembers the page, counts a chapter or volume as read at its end and offers the next one.

    Together with friends

    • Watch together puts you and your friends in a room on a Syncplay server: pause, seek and the next episode happen for everyone, with a chat. An invite link opens the room in a friend's Kioku; friends with Syncplay itself can join too.
    • Friends shows the people you follow on AniList and what they watched and read lately, and compares your tastes with any of them.
    • Lists are your own lists of any titles, in your order with a note each. Share a list or a single title as a link that opens in a friend's Kioku, as text with AniList pages, or as a file. Your friend sees a preview and keeps it as a list, adds the titles to their library or picks single ones.

    Characters, staff and studios

    • Characters, Staff and Studios keep the ones you like, with their pictures, newest first; AniList favourites can be imported.
    • Their pages come from AniList: details, description, and the works they are part of, with voice actors, voice roles and credits; every work opens or goes to Planning with one click.

    Seasons, schedule, notifications and stats

    • Seasons shows each anime season with countdowns, streaming services and one-click adding, plus the shows still airing and the announced ones.
    • Schedule is the week's airing timetable in your time zone. Its calendar feed brings the episodes from your list into calendar apps, or into a file for web calendars.
    • Notifications when new episodes air and when sequels are announced: in the app, on the desktop, through Web Push, ntfy, Gotify, Discord webhooks or any webhook, with a delay after broadcast, quiet hours, a daily digest and per-title settings.
    • Stats sums up time watched, chapters read, scores, genres and your activity, and Your year looks back at any year.

    Your data

    • Kioku backs up the library before every sync or import that changes it and once a day when it changed, keeps the last ten, and can copy each one to a folder of your choice. Settings > Data lists them and restores one (Kioku backs up the current state first and restarts with the backup).
    • Moving to another computer: restore a backup file from the old computer, or export the library file there and import it on the new one.
    • Logins and passwords are kept in the system keychain (Windows Credential Manager, macOS Keychain, Secret Service on Linux), never in the database.

    Kioku accounts

    • An account on kioku.toxik.space keeps your library on the server, synced with the app on every computer you log in from and open in any browser or phone.
    • Sign-up is by invite code; members hand out codes to friends.

    Look and feel

    • Light and dark themes, an interface colour of your choice (a preset, any colour, or one taken from a picture), with light and dark versions worked out so text stays readable.
    • English and Slovak.
    • A native window without browser menus, and every page works at phone width.
    • Kioku checks for new releases twice a day; on Windows and Linux it installs them (checked against the published checksums) and restarts into them.

    As a server

    kioku serve runs Kioku without a window, for a home server or a NAS. It can be reached from other devices with a password set (kioku hash-password). The read-me covers the configuration.

    Good to know

    • Following other players reads window titles on your computer only. On macOS Kioku cannot see other players.
    • MyAnimeList and AniDB let apps in only with a client registration you make yourself; Sync walks you through it. AniList and Kitsu work right away, MangaBaka with an API key you create on its site.
    • AniDB's protocol sends your password unencrypted; Kioku warns before you turn on what needs it.
    • AniList logins return to http://127.0.0.1:7777. If another program uses that port, Kioku moves to a free one and says so; close the other program before connecting AniList.
    • macOS cannot install updates by itself: Kioku links to the download.
    Downloads