*********************************
USB Recycle Bin - Readme / Help
*********************************




*** 1] Installation:

You must start by decompressing the application found on this site:
	USB-Recycle-Bin.SourceForge.io

Then, there are 3 executable files in the folder, including one for the installation, which must be executed before any use:
	INSTALL - USB Recycle Bin.exe


For this app to work, you absolutely need to get the TRANSLATION in your language, or fill in the System section of the Translation File. See the Translation Section below.




*** 2] Use:

A single installation of USB Recycle Bin, alias URBin, protects all your USB keys with a Recycle Bin.
This USB Recycle Bin is capable of restoring deleted files from your USB Flash Drives.

The application also works on remote servers, such as NAS, if they are mounted on a Windows drive letter (D, E, F, ..., Z).

As long as the Recycle Bin is not created on a USB key: you can continue to delete files, but with a warning saying that this deletion is irreversible, as with Windows on USB keys. However, this same dialog also offers you to create a Recycle Bin on your USB key.

Once the Recycle Bin is created, you can delete any file automatically moved to the Recycle Bin, as on a normal Windows hard drive. Except doing a [Shift-Del] like on Windows, or putting the application in Pause, which permanently deletes the files.

By default, files or folders larger than 1 GB cannot be moved to the Recycle Bin.

Then, the application offers to delete them or move them anyway to the Recycle Bin.

The Recycle Bin is a folder, so you can view and explore its contents there, including files and folders.

You can see a preview of the origin of deleted files and folders.

Each Recycle Bin is controlled by right clicks, allowing you to:
- Restore files to their original folder.
- Delete files from the Recycle Bin, which is final.
- Empty the Recycle Bin, and all its content.
- Delete finally the Recycle Bin.

By default, the USB Recycle Bin automatically deletes files older than 3 weeks.

Near the clock, the green trash can icon allows you to:
- Display the “About” message describing the application.
- Display this help, normally translated into your language.
- Open the application folder.
- Modify the automatic start with Windows.
- Pause the application to restore normal Windows functions.
- Relaunch or Exit the application.

There are no automatic updates, so to get the translation files, you need to go to the URBin page, located on this website:
	USB-Recycle-Bin.SourceForge.io




*** 3] Translation:

The application has almost no bugs, but needs translators to edit or create the translation text files.

To translate a language, go to the folder:   .\Translations\. 

This folder contains [*.lng.ini.txt] text files which can be edited with any Unicode text editor as *.ini files

There is a file called “Create New Translation” which can be translated and renamed in your language.

You cannot use accents to rename your translation files (because of SourceForge).

The most important thing is to translate the system section of the “Windows Deletion Dialog Boxes” of the various files.

This consists of entering the exact title of the 4 Windows dialog boxes, which indicate the deletion of USB files.
Like this in english:
- Delete a file
- Delete a folder
- Delete a shortcut
- Delete several elements

Warning: for the application to work, translators must complete this System Section, even if the translation remains in English.

To do this, simply try to delete each type of file present on a USB key, and read exactly the title of the corresponding dialog box.

Then the rest of the text can be freely translated as you see fit.

To try your translation, just install the application somewhere ( avoid C:\ ), then try as many options as possible ...

Then you have to translate this [Help] into your language, from this file, and put it in the translation folder.

Once this is done, it is important to publish your translation files on the URBin Website (or to contact a developer), in order to help your language users.




*** 4] Advanced configuration:

The application can be configured (with caution) using the file:   Config.txt.ini

This configuration file mainly allows you to edit:
- The default name of the Recycle Bin to create.
- The maximum deletion size of files that will not be sent to the USB Recycle Bin.
- The number of days of too old files to be automatically deleted from the USB Recycle Bin.
- And some specific features ...

If you have problems saving files, use Notepad++




*** 5] Development:

The source code (supplied with the application) consists of 3 or 4 text files for the AutoHotKey engine: [*.txt.ahk]

We recommend that you use the development environment called “AutoHotKey Studio” (link provided) and make it the default editor.

You can thus edit each source with a right click, then modify them.

Then, to try the [*.txt.ahk] sources, just double-click on each file to launch it using the AutoHotKey engine.

This is a French project, so the names in the code follows the logical rule of indexing and autocompletion, but keeps the English vocabulary.

The code needs help to translate comments ...




*** 6] Heuristic Antivirus:

There is a problem with heuristic antiviruses, as with any other AutoHotKey program.

This is due to the power of the AutoHotKey engine, yet opensource.

A simple compilation of [ MsgBox  Hello World ] will allow you to judge.




*** 7] Ressource:

Engine:    			AutoHotKey V1 (Opensource) on: https://www.autohotkey.com/ 

Help: 				https://www.autohotkey.com/docs/AutoHotkey.htm

Development: 		AutoHotkey Studio (Opensource) on: https://www.autohotkey.com/boards/viewtopic.php?t=300 

Compilation: 		AHK Compiler (Opensource) on: https://www.autohotkey.com/boards/viewtopic.php?t=16061 






