Skip to content

Latest commit

 

History

250 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

๐ŸŒธ VnManager

DO NOT DOWNLOAD RIGHT NOW 0.3 ON ITS WAY AND BUNCH OF REQUIREMENT DOWNLOADS ARE BROKEN

A cute little desktop app for tracking your visual novel backlog, built because spreadsheets are not kawaii enough โœจ

Pulls everything straight from VNDB be it covers, ratings, tags, descriptions, release info, all that in a pink fluffy UI you'll actually enjoy looking at (I hope).

Python CustomTkinter License


Screenshots

Library Library view

Searching VnDB (list) Search window

Searching VnDB (grid) Search window

VN details VN detail popup


Features

  • Search the VNDB database by title (expanding the search function is in plan)
  • Add VNs to custom categories (defaults: Not finished, Finished, Planned)
  • Covers, ratings, tags, and descriptions displayed at a glance
  • Click any cover or title to open a full detail popup
  • Leave personal notes on any VN in your library
  • Move VNs between categories easily
  • Rename and delete categories whenever you feel like reorganising
  • Filter VNs within a category using the top search bar
  • Sort by date added, title, rating, release date, or length
  • NSFW content toggle in search (suggestive and explicit separately)
  • Touchpad scroll support on Linux
  • Everything saves locally: no account, no cloud

Requirements

  • Python : Only tested with Python 3.14.3 but should work with 3.10 or newer
  • On Linux: tk package (sudo pacman -S tk or sudo apt install python3-tk)

How to install

Windows

Download the latest VnManager.exe from the releases page.

Arch Linux (AUR)

yay -S vnmanager

Linux (other distros)

Download the latest VnManager-x86_64.AppImage from the releases page.

chmod +x VnManager-x86_64.AppImage
./VnManager-x86_64.AppImage

Seems to break on debian right now (only archlinux was tested)

From source

git clone https://github.com/Rukeh/VnManager.git
cd VnManager
pip install -r requirements.txt
python main.py

You will probably need to create a virtual environment.

Linux/Wayland: If the window doesn't open, try GDK_BACKEND=x11 python main.py


๐Ÿ—’๏ธ Notes

Personal project made out of frustration with having nowhere cute to track VNs. Not trying to replace your VNDB lists just a nice local companion for your backlog.

If something breaks or you have an idea, feel free to open an issue โ™ก


๐Ÿ“„ License

MIT โ€” see LICENSE

Disclaimer

Some backend components were made with the help of AI

About

Desktop app to track Visual Novels using the VNDB database

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages