just a desktop client i made for browsing booru imageboards (gelbooru, danbooru, safebooru, etc.) without having to deal with their web interfaces or ads.
i mostly built this because doing bulk downloads and organizing tags manually is annoying. it's written in python using pyqt6.
if you just want to use the app, you don't need to mess with python. check the releases tab for the standalone .exe. no install needed, just run it.
- tag searching: search multiple supported boorus with standard tag syntax.
- smart downloads: automatically sorts your downloaded images into folders based on tags (like grouping by artist or character).
- built-in media player: view images, gifs, and videos directly in the app without launching a browser.
- bookmarks & favorites: keep track of posts and save them locally.
- cloudflare bypass: boorus love to throw up cloudflare checks. this app rotates through a few http engines (like
curl_cffi) to spoof a real browser's tls so you don't get blocked while scrolling. - smooth gallery: scrolling doesn't lag even with thousands of posts because it caches thumbnails locally in sqlite and recycles ui widgets instead of rendering everything at once.
if you want to run the code yourself instead of using the exe:
- make sure you have python 3.12 or newer installed.
- install the dependencies:
pip install -r requirements.txt
- run the app:
python main.py
note: for the best video playback support, you'll probably want VLC installed on your system so the app can hook into it.
this is a side project, but i tried to keep the code organized and modular.
feel free to open an issue or submit a pull request if you want to fix a bug, add a feature, or write an adapter for a new booru site.