hydrus/help/running_from_source.html

<html>
	<head>
		<title>running from source</title>
		<link href="hydrus.ico" rel="shortcut icon" />
		<link href="style.css" rel="stylesheet" type="text/css" />
	</head>
	<body>
		<div class="content">
			<h3>running from source</h3>
			<p>I write the client and server entirely in <a href="http://python.org">python</a>, 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.</p>
			<h3>what you will need</h3>
			<p>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.</p>
			<p>I recently got the client working on Ubuntu 13.10, which required:</p>
			<p><ul>
				<li>sudo pip install beautifulsoup4</li>
				<li>sudo pip install pyyaml</li>
				<li>sudo pip install python-potr</li>
				<li>sudo pip install hsaudiotag</li>
				<li>sudo pip install PyPDF2</li>
				<li>sudo pip install flvlib</li>
				<li>sudo pip install pafy</li>
				<li>sudo apt-get install python-numpy</li>
				<li>sudo apt-get install python-opencv</li>
				<li>and installing a recent version of wxPython, which is difficult and best done <a href="http://wiki.wxpython.org/CheckInstall">like so</a></li>
			</ul></p>
			<p>YMMV. Feel free to email me if you run into trouble or discover any neat tricks.</p>
			<p>OS X 10.9 required a similar pattern to above, though wx was simpler. I use the cocoa package <a href="http://wxpython.org/download.php#osx">straight from wxPython's site</a>.</p>
			<p>Some people have encountered problems with wxPython 3.0, so I use 2.9.x. Again, YMMV.</p>
			<p>Once you have everything set up, client.pyw and server.pyw should look for and run off the database files just like the executables.</p>
			<p>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.</p>
			<h3>my coding</h3>
			<p>I find I work very much on a conceptual, boxes-and-arrows level. Although I <i>can</i> code in any language, I find the pedantic intricacies of C and its low-level friends a pain, and not worth the performance gain. Python works with little hassle and semantically rich in a way I appreciate; one line of intelligent and word-heavy python can do the work of 20 robotic <i>t+=ord(j_temp)%2;</i>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.</p>
			<p>If you want to contribute to the project, please do! You can send the changes over <a href="https://github.com/hydrusnetwork/hydrus">github</a>, 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!</p>
			<p>I'm not enough of a participant in the open source community to release my code under a specific licence, so everything is just <a href="http://sam.zoy.org/wtfpl/COPYING">WTFPL</a>. In our internet age, I see copyright and copyleft as equally impotent.</p>
		</div>
	</body>
</html>
Initial commit from version 57 2013-02-19 00:11:43 +00:00			`<html>`
			`<head>`
			`<title>running from source</title>`
			`<link href="hydrus.ico" rel="shortcut icon" />`
			`<link href="style.css" rel="stylesheet" type="text/css" />`
			`</head>`
			`<body>`
			`<div class="content">`
			`<h3>running from source</h3>`
Version 102 2014-02-05 20:54:28 +00:00			`<p>I write the client and server entirely in <a href="http://python.org">python</a>, 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.</p>`
Initial commit from version 57 2013-02-19 00:11:43 +00:00			`<h3>what you will need</h3>`
Version 102 2014-02-05 20:54:28 +00:00			`<p>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.</p>`
			`<p>I recently got the client working on Ubuntu 13.10, which required:</p>`
Initial commit from version 57 2013-02-19 00:11:43 +00:00			`<p><ul>`
Version 102 2014-02-05 20:54:28 +00:00			`<li>sudo pip install beautifulsoup4</li>`
			`<li>sudo pip install pyyaml</li>`
			`<li>sudo pip install python-potr</li>`
			`<li>sudo pip install hsaudiotag</li>`
			`<li>sudo pip install PyPDF2</li>`
			`<li>sudo pip install flvlib</li>`
			`<li>sudo pip install pafy</li>`
			`<li>sudo apt-get install python-numpy</li>`
			`<li>sudo apt-get install python-opencv</li>`
			`<li>and installing a recent version of wxPython, which is difficult and best done <a href="http://wiki.wxpython.org/CheckInstall">like so</a></li>`
Initial commit from version 57 2013-02-19 00:11:43 +00:00			`</ul></p>`
Version 102 2014-02-05 20:54:28 +00:00			`<p>YMMV. Feel free to email me if you run into trouble or discover any neat tricks.</p>`
			`<p>OS X 10.9 required a similar pattern to above, though wx was simpler. I use the cocoa package <a href="http://wxpython.org/download.php#osx">straight from wxPython's site</a>.</p>`
			`<p>Some people have encountered problems with wxPython 3.0, so I use 2.9.x. Again, YMMV.</p>`
			`<p>Once you have everything set up, client.pyw and server.pyw should look for and run off the database files just like the executables.</p>`
			`<p>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.</p>`
Initial commit from version 57 2013-02-19 00:11:43 +00:00			`<h3>my coding</h3>`
Version 102 2014-02-05 20:54:28 +00:00			<p>I find I work very much on a conceptual, boxes-and-arrows level. Although I <i>can</i> code in any language, I find the pedantic intricacies of C and its low-level friends a pain, and not worth the performance gain. Python works with little hassle and semantically rich in a way I appreciate; one line of intelligent and word-heavy python can do the work of 20 robotic <i>t+=ord(j_temp)%2;</i>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.</p>
			`<p>If you want to contribute to the project, please do! You can send the changes over <a href="https://github.com/hydrusnetwork/hydrus">github</a>, 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!</p>`
			`<p>I'm not enough of a participant in the open source community to release my code under a specific licence, so everything is just <a href="http://sam.zoy.org/wtfpl/COPYING">WTFPL</a>. In our internet age, I see copyright and copyleft as equally impotent.</p>`
Initial commit from version 57 2013-02-19 00:11:43 +00:00			`</div>`
			`</body>`
			`</html>`