A personal booru-style media tagger that can import files and tags from your hard drive and popular websites. Content can be shared with other users via user-run servers.
Go to file
bbappserver 8e7d089c64 Short Cache-Control header for dynamic pages
Letting the caller know that a response is valid for 4 seconds makes them a lot less chatty with hydrus which significantly boosts responsiveness, on both client side and means that the caller can bother hydrus less.

If we're being honest this is mostly to stop Hydrus-Companion from asking about URL status so often, since only web browsers look at cache control anyway.  Depending on web browser hydrus companion can send a request to get url info up to 6 times just for loading a page, and this really adds up.  Also it will re ask when cycling tabs or windows back into focus even if you were just looking at them.

4 seconds is a decent compromise between treating the page as dynamic and realizing that hydrus mostly won't change its ind in under 4 seconds.  If a browser extension wants to bypass that it can do so by properly configuring the `xhr`
2022-08-27 20:28:31 -07:00
.github Version 497 2022-08-24 16:06:25 -05:00
bin Version 422 2020-12-16 16:29:51 -06:00
db Version 491 2022-07-13 16:35:17 -05:00
docs Version 497 2022-08-24 16:06:25 -05:00
hydrus Short Cache-Control header for dynamic pages 2022-08-27 20:28:31 -07:00
static Version 497 2022-08-24 16:06:25 -05:00
.gitignore Add building docs to GitHub Actions for release 2022-02-15 05:44:11 -06:00
COPYING adding the WTFPL License 2013-02-18 16:15:40 -08:00
README.md Some basic docs updates 2022-02-22 17:35:58 -06:00
client.py Version 427 2021-01-27 16:14:03 -06:00
client.pyw Version 427 2021-01-27 16:14:03 -06:00
help my client will not boot.txt Version 402 2020-06-24 16:25:24 -05:00
license.txt Version 365 2019-08-21 16:34:01 -05:00
mkdocs-gh-pages.yml Version 479 2022-03-30 15:28:13 -05:00
mkdocs.yml Removing export page nav entry 2022-05-28 03:08:27 +02:00
requirements_macos.txt Version 477 2022-03-15 21:52:54 -05:00
requirements_macos_build.txt Some basic docs updates 2022-02-22 17:35:58 -06:00
requirements_ubuntu.txt Version 477 2022-03-15 21:52:54 -05:00
requirements_ubuntu_build.txt Some basic docs updates 2022-02-22 17:35:58 -06:00
requirements_windows.txt Version 477 2022-03-15 21:52:54 -05:00
requirements_windows_build.txt Some basic docs updates 2022-02-22 17:35:58 -06:00
server.py Version 427 2021-01-27 16:14:03 -06:00
test.py Version 427 2021-01-27 16:14:03 -06:00

README.md

Hydrus Network (Client and Server)

The hydrus network client is an application written for Anon and other internet-fluent media nerds who have large image/swf/webm collections. It browses with tags instead of folders, a little like a booru on your desktop. Advanced users can share tags and files anonymously through custom servers that any user may run. Everything is free and privacy is the first concern. Executable releases are available for Windows, Linux, and macOS. The program is in python, so you can also run it straight from the source code.

I am continually working on the software and try to put out a new release every Wednesday by 8pm EST.

This github repository is currently a weekly sync with my home dev environment, where I work on hydrus by myself. Feel free to fork and do whatever you like with my code, but please do not make pull requests. The issue tracker here on Github is active and run by blessed volunteer users. I am not active here on Github, and I have difficulty keeping up with social media in general, but I welcome feedback of any sort and will eventually catch up with and reply to email, the 8chan or Endchan, tumblr, twitter, or the discord.

The client can do quite a lot! Please check out the help inside the release or here, which includes a comprehensive getting started guide. If you are running from source and would like a local copy of the help, check here!

A rudimentary documentation for the container setup can be found here.

Attribution

I use a number of the Silk Icons by Mark James at famfamfam.com.