Skip to content

z00mable/TokyBay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TokyBay

Search, download, and tag audiobooks from multiple sites — automatically converted to M4B or MP3, with cover art, author, narrator, and chapter titles embedded directly into every file.

Important

Tokybook.com is currently undergoing a major platform overhaul and the website is temporarily closed. However, TokyBay continues to work — search and downloads still function via the Tokybook API.

Note

This project is intended for educational purposes only. Please respect copyright laws and the terms of service of the respective websites.

Last Updated Downloads Repo Stars C# Platform License PRs Welcome Issues

Table of Contents

TokyBay Demo


Quick Start (No technical knowledge required)

No programming knowledge needed. No installation. Just download and run.

Step 1 — Download TokyBay

Go to the latest release page and download the file for your operating system:

Your system File to download
Windows tokybay-win-x64.zip
Linux (64-bit) tokybay-linux-x64.zip
Linux (ARM, e.g. Raspberry Pi) tokybay-linux-arm64.zip
macOS (Intel) tokybay-osx-x64.zip
macOS (Apple Silicon M1/M2/M3) tokybay-osx-arm64.zip

Step 2 — Extract the ZIP

Extract the downloaded ZIP file to any folder you like (e.g. your Desktop or Downloads folder).

Step 3 — Run TokyBay

  • Windows: Double-click tokybay.exe — or right-click it and select Open in Terminal
  • Linux / macOS: Open a terminal in the extracted folder and run ./tokybay

Note

On macOS you may need to allow the binary in System Settings → Privacy & Security on first launch.

That's it. TokyBay will guide you through the rest.

Note

On first start, TokyBay will automatically download FFmpeg — the tool it uses to convert audio files. This happens once and requires an internet connection.


Supported Sites

Last checked: 2026-04-08

Site Status
appaudiobooks.com 🟢 Working
audioaz.com 🟢 Working
audiozaic.com 🟢 Working
bigaudiobooks.net 🟢 Working
bookaudiobook.net 🟢 Working
findaudiobook.com 🟢 Working
freeaudiobooks.top 🔴 Currently unreachable
fulllengthaudiobooks.net 🟢 Working
goldenaudiobook.net 🟢 Working
hdaudiobooks.net 🟢 Working
hotaudiobooks.com 🟢 Working
tokybook.com 🔴 Website temporarily offline, 🟢 API operational
zaudiobooks.com 🔴 Currently unreachable

Features

  1. Search: Search and find audiobooks by title on Tokybook.com
  2. Direct URL download: Download any audiobook directly by URL on supported sites
  3. M4B conversion: Automatically convert to the M4B audiobook format after download
  4. MP3 conversion: Automatically convert to MP3 format after download
  5. Metadata tagging: Embeds rich metadata into every converted file — cover art, author, narrator, chapter title, track number, genre, description, and publisher
  6. Multi-site support: Works with Tokybook and many other sites
  7. Settings: Persistent in-app settings — download path, conversion preferences

Embedded Metadata

Every downloaded chapter is tagged automatically so your audiobook player displays the right information:

Tag Source
Cover art Fetched from the book page and embedded as attached picture
Author Read from original MP3 tags first, then extracted from the site's structured data or page title
Narrator Extracted where available (Tokybook and AudioAZ carry this natively)
Year Read from original MP3 tags (publication year is often embedded in the source file)
Chapter title File name or track title from the playlist
Track number Chapter position and total count (e.g. 3/24)
Genre Always set to Audiobook
Description Read from original MP3 tags first, then extracted from book synopsis on the page
Publisher Where available (Tokybook carries this natively)

Usage

Search

  1. Select Search from the main menu
  2. Enter your search query
  3. Select the desired book from the results
  4. TokyBay automatically downloads and converts all chapters

Direct URL Download

  1. Select Download from URL from the main menu
  2. Paste the audiobook URL (any supported site)
  3. TokyBay automatically downloads and converts all chapters

Settings

  • Change the download path
  • Toggle automatic M4B conversion
  • Toggle automatic MP3 conversion
  • Change the FFmpeg binary path

Tip

By default, TokyBay downloads to your Music folder on Windows (C:\Users\<User>\Music) or your home directory on Linux/macOS. You can change this inside the app's settings, or pass a custom path via -d "C:\Path\To\Downloads" when launching from the terminal.


For Developers

Build from source

Prerequisites

Clone and run

git clone https://github.com/z00mable/TokyBay.git
cd TokyBay
dotnet restore
dotnet build
dotnet run --project TokyBay -- -d "C:\Users\User\Music"

Publish self-contained binaries

dotnet publish -c Release -r win-x64 --self-contained
dotnet publish -c Release -r linux-x64 --self-contained
dotnet publish -c Release -r linux-arm64 --self-contained
dotnet publish -c Release -r osx-x64 --self-contained
dotnet publish -c Release -r osx-arm64 --self-contained

Adding a new site

  1. Create a new class in TokyBay/Scraper/Strategies/ extending BaseScraperStrategy
  2. Implement CanHandle(string url) — URL-based detection
  3. Implement DownloadBookAsync(string url) — fetch metadata, then call ProcessTracksInParallelAsync
  4. Register it in ScraperServiceExtensions.cs:
    services.AddTransient<IScraperStrategy, YourNewStrategy>();

License

FFmpeg is mainly LGPL-licensed with optional components licensed under GPL. See the FFmpeg license for details.

Xabe.FFmpeg is licensed under CC BY-NC-SA 3.0 for non-commercial use. For commercial use, see Xabe.FFmpeg licensing.

Credits

Inspired by:

About

Search & download audiobooks from multiple sites and convert them automatically to the audiobook-friendly M4B format or good old MP3. No installation needed.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages