running from source

I write the client and server entirely in python, which can run straight from source. I don't recommended this for someone who just wants to get the program working, but rather for those who have a general interest or wish to modify the program.

what you will need

You will need to install python 2.7 and several python modules. To see what your system needs, just keep running client.pyw and see what it complains about missing.

I recently got the client working on Ubuntu 14.04, which required:

• sudo apt-get install python2.7-dev
• sudo pip install beautifulsoup4 pyyaml python-potr hsaudiotag PyPDF2 flvlib pafy lz4
• sudo apt-get install python-numpy
• sudo apt-get install python-opencv
• sudo apt-get install python-wxversion
• and installing a recent version of wxPython, which is difficult and best done like so
• If you install wxPython as above and you get missing .so errors, try running 'sudo ldconfig'

YMMV. Feel free to email me if you run into trouble or discover any neat tricks.

OS X 10.9 requires a similar pattern to above, though wx is simpler. I use the cocoa package straight from wxPython's site. One user reports that this worked for 10.7:

• sudo pip install beautifulsoup4 pyyaml python-potr hsaudiotag PyPDF2 flvlib pafy numpy pil lxml lz4
• brew tap homebrew/homebrew-science
• brew install opencv
• export PYTHONPATH=/usr/local/lib/python2.7/site-packages:$PYTHONPATH

For Windows, you can do the same thing with easy_install and pip and module installers. Since it doesn't natively come with Python, you'll probably need to go through a bigger list. You'll find this page very helpful. I have a fair bit of experience with Windows python, so send me a mail if you need help.

Some people have encountered problems with wxPython 3.0, so I use 2.9.x in my official releases. Again, YMMV.

You'll probably want to install Pillow (pip should do it for Linux/OS X, easy_install for Windows) instead of PIL, but go back to PIL if Pillow doesn't work.

If you want to import videos, you will need to put a static FFMPEG executable in the install_dir/bin directory. Have a look at how I do it in the extractable compiled releases if you can't figure it out. You can either copy the exe from one of those releases, or download it right from the FFMPEG site. I don't include the FFMPEG exes in the source release like I do upnpc just because they are so big.

Once you have everything set up, client.pyw and server.pyw should look for and run off the database files just like the executables.

I develop hydrus on 64-bit Win 7, so the program is much more stable and reasonable on Windows. I am developing for Linux and OS X, but I do not have as much experience with them, so I would particularly appreciate your Linux/OS X bug reports and any informed suggestions.

my code

I find I work very much on a conceptual, boxes-and-arrows level. Although I can code in any language, I find the pedantic intricacies of C and its low-level friends a pain to work with, and not worth the performance gain. Python works with little hassle in a semantically rich way I appreciate; one line of intelligent and word-heavy python can do the work of 20 robotic t+=ord(j_temp)%2;s in C, and with far less fear of memory leaks or injection attacks or buffer overflows. I like long variable names and copious whitespace. I don't do much commenting because I am working alone and it usually makes quick sense to me, even when I haven't seen something for ages. If my code looks kooky to you, I'm sorry; my nerdism is INFJ, not INTP/J.

If you want to contribute to the project, please do! You can send the changes over github, or just email them to me. I'm pretty OCD about my code style and grammar though, so be warned that I'll probably rewrite everything you submit!

I'm not enough of a participant in the open source community to release my code under a specific licence, so everything is just WTFPL. In our internet age, I see copyright and copyleft as equally impotent.