Tadoku - Visual Novel Tracker
Tadoku is a modern, blazing-fast Visual Novel (VN) tracker designed for Japanese learners and casual readers. It helps you manage your VN library, track playtime, and organize your reading progress. Built with Tauri and SvelteKit, Tadoku offers a lightweight, cross-platform experience with a sleek and intuitive user interface.
Features
- Track Playtime: Automatically tracks how much time you've spent reading each Visual Novel.
- Game Management: Add, edit, and remove Visual Novels from your library.
- NSFW Filter: Blurs NSFW images by default
- Pinned Games: Pin your favorite games for quick access.
- Character Tracking: Optionally include character information for each Visual Novel.
- Cross-Platform: Works on Windows, with basic Linux support (need to build from source).
- Discord Rich Presence: Share your current reading activity on Discord.
Screenshots
Main Library View
Game Details Page
Add Game Modal
Characters Page
Installation
Prerequisites
Steps
Clone the repository:
git clone https://github.com/your-username/tadoku.git
cd tadoku
Install dependencies:
bun install
Build and run the app:
bun run tauri dev
For production builds:
bun run tauri build
Usage
Add a Game:
- Click the
+
button to add a new Visual Novel.
- Search for the game by name or ID using the VNDB API.
- Select the game and provide the path to the executable.
Track Playtime:
- Start a game from the library, and Tadoku will automatically track your playtime.
- Playtime is displayed in hours and minutes on the game's details page.
Pin Games:
- Pin your favorite games to the sidebar for quick access.
View Characters:
- If enabled, view character information for each Visual Novel.
Discord Integration:
- Tadoku updates your Discord status with the current game you're playing.
Contributing
Contributions are welcome! If you'd like to contribute, please follow these steps:
- Fork the repository.
- Create a new branch for your feature or bugfix.
- Submit a pull request with a detailed description of your changes.
Acknowledgments
- Tauri: For providing a lightweight framework to build cross-platform apps.
- VNDB: For their comprehensive Visual Novel database API.
- SvelteKit: For enabling a fast and reactive frontend.
Support
If you encounter any issues or have suggestions, please open an issue on the GitHub repository.
Enjoy tracking your Visual Novels with Tadoku! 📚✨