bin2img converter v2.3 final
(c) 2010-2012 thecodemonkey
------------------------------------------
Introduction
------------
bin2img v2.3 is a tool, that converts regular (i.e. binary) files to the Portable Network Graphics format (PNG), which enables the user to upload these files to image hosting sites. Usually on these sites you only can upload images. Therefore the tool encodes the byte structure of a file to corresponding pixel colors. 


Important
---------
- Use the program at your own risk
- It is strictly and explicitly prohibited to use bin2img for sharing copyrighted and/or any kind of illegal files
- We can _NOT_ be held liable for data loss, copyright infringements and/or other illegal actions of the users
- We do _NOT_ host any uploaded files, b2i://-links are auto-generated meta links that re-link to the real destination (Base64 encoded → no encryption)
- The users must read and accept the Terms Of Service of the image hosting sites they use. The users are responsible for their uploads / downloads and must find out _BEFORE_ uploading / downloading anything if they are permitted 
	* to use bulk upload / download tools 
	* to upload images containing binary data coded in the pixel colors. 
	Otherwise the hosting site owners might delete accounts and/or all images and/or take other (legal) actions
- The tool 
	* does _NOT_ use inline linking (a.k.a. hotlinks), unless image hosting sites provide such links exclusively
	* does _NOT_ use hacking or other illegal methods to upload and download (such as exploiting server software errors, flooding, Denial of service, CAPTCHA breaking). Network requests are put just the way like a regular browser would do (using the HTTP protocol, javascript interpretation)
	* is licensed under the terms of the European Union Public License v1.1


Requirements
------------
- Java Runtime Environment 1.7 or later must be installed (get it at http://www.oracle.com)
- 2 GB or more RAM is highly recommended


Release notes v2.3 final
-------------------------------
- Updated uploader to v2.1 which contains various changes and bug fixes in uploader core
- Improved URL encoding module

Installation
------------
- First make sure you have installed Java Runtime Environment 1.7 or later
- if you downloaded the Windows Installer, simply run the installer and follow the instructions.

Otherwise:
- extract the contents of the archive to a directory (e.g. "c:\Program Files" on Windows or "/opt" on Linux) 
- make the directory writable (Windows-Explorer: Right click on directory -> Properties -> ..., Linux: "chmod" command  ). 
- Run the bin2img.exe file (Windows portable packages) or the jar file bin2img.jar
	Linux: "java -jar /path/to/bin2img.jar" 
	Windows: "javaw.exe -jar C:\Path\To\bin2img.jar", or simply double click, assuming jar files are associated with javaw.exe
- Manually registering an URL handler for the b2i:// URL protocol:
	Windows:	
	* change the paths accordingly in the Windows registry file "b2i_protocol.reg" (e.g. with notepad)
	* run regedit
	* import the reg file
	Linux:
	* desktop dependant -> So for now: Google is your friend. I might insert this information later
	
	
