README.TXT
----------

NOTE: The Mono Framework and GTK are required for this application to run.  Please download from here:

	http://www.mono-project.com/download/	
	(Windows users also need to download and install the GTK# for .NET.)

Model File Manager
------------------
I wrote this little utility to manage the model files on my Devo 7E running DeviationTX.  The program
works by searching for a removeable drive that looks like a Deviation install.  When it finds one
it will look at all the models and list them in the main window.  From there you can manage your
model files using the buttons on the right.  If you have an editor for your model files, you can also
configure the double-click on a model to open the file for editing.*


Running the Program**
-------------------
To start the program, extract the downloaded ZIP file and run the "ModelFileManager.exe" file the way 
you normally execute a Mono/GTK applications.  For convenience, a Windows batch file and a Mac OS X 
shell script have been included.
	
On Windows:
	- Open a file explorer to the location you unzipped the files
	- Double-click the file:
		ModelFileManager.bat

On Linux:
	- Open a Terminal window
	- Change directory to the location you unzipped the files
	- Run the command:
		mono ModelFileManager.exe

On Mac OS X:
	- Open a Terminal window
	- Change directory to the location you unzipped the files
	- Run the command:
		./ModelFileManager.sh


Functions
---------

[Backup All]
This will backup the entire models folder to the backup directory using the current date and time as
the folder name.  These backups can then be used to later to restore the models directory... if the 
need arises.

[Restore...]
Ths will allow you to restore a previous backup to the current models directory.  Please note that
any existing model files in the model directory WILL BE DELETED.  Use with caution.  

You can restore your entire model directory or an individual model.  On this window, you may also 
view the model.ini to be restored by clicking on the View... button next to the model
selected to restore.  

Furthermore, if a destination model is selected, you may also view the differences between the model 
you are restoring and the model file you are replacing.  Just click the Diff... button next to the 
selected destination.*

[Import...]
This will allow you to select an external model file and have it added to your transmitter model. By
default the imported model will be placed in the next available empty model slot.

[Move Up/Move Down]
This will move the selected model up or down in the model list.

[Copy]
This will copy the selected model to next available empty model slot.

[Clear]
This will clear the currently selected model to an empty model.

[Rename]
This will allow you to rename the currently selected model.


*Settings File
--------------
You can specify an exe to edit the modelX.ini file by editing a setting in the file:

   ModelFileManager.exe.config

In the config file change the "ModelEditor" value to the path of your desired exe.  Once the 
setting is setup correctly, just double-click on the selected model.  

Likewise, you can specify a number of other settings...

	BackupViewer			- Clicking View... button in the Restore window
	DiffViewer				- Clicking Diff... button in the Restore window
	ModelConverter			- Used instead of FileCopy to import a file
	BackupPath				- Defines the sub-directory where the backup files will be stored
    ConfigName				- Used in the main window title to identify the active config**
    LowSpaceWarningLimit	- A warning will be shown if the transmitter has less than this
                              amount of space available	
	ResetCurrentModel		- Set this to 'Y' to enable resetting the current model to Model
							  #1, when the current model selected may be invalid.


**Using An Alternate Settings File
----------------------------------
You can force the application to use a specific config file by passing the full file spec to the
EXE as a single parameter.  This will allow you to manage more than one DeviationTX transmitter.


Building the Application from Source
------------------------------------

On Linux:

	1. Install Mono.
	   If your distribution has a fairly recent version packaged for it then you should use that
	   otherwise, go to http://www.mono-project.com/download/ and follow the instructions for your
	   distribution.
	2. Install MonoDevelop (called Xamarin Studio for Windows and MAC)
	   Again, if your distribution has a fairly recent version packaged for it then you should use 
	   that otherwise, go to http://www.monodevelop.com/download/ and follow the instructions for 
	   your distribution.
	3. Unzip the SOURCE.ZIP somewhere one your system
	4. Start MonoDevelop/Xamarin Studio and open ModelFileManager.sln in the ModelFileManager 
	   folder.
	5. Select Build All from the Build menu.

On Windows:

	1. Install Mono.
	   Go to http://www.mono-project.com/download/ and follow the instructions for your installing
	   Mono on Windows.  Note: You will have to install GTK# as well.
	2. Install Xamarin Studio for Windows
	   Go to http://www.monodevelop.com/download/ and follow the instructions for installing 
	   Xamarin Studio.
	3. Unzip the SOURCE.ZIP somewhere one your system
	4. Start Xamarin Studio and open ModelFileManager.sln in the ModelFileManager folder.
	5. Select Build All from the Build menu.

On Mac OS X:

	1. Install Mono.
	   Go to http://www.mono-project.com/download/ and follow the instructions for your installing
	   Mono on OS X.
	2. Install Xamarin Studio for OS X
	   Go to http://www.monodevelop.com/download/ and follow the instructions for installing 
	   Xamarin Studio.
	3. Unzip the SOURCE.ZIP somewhere one your system
	4. Start Xamarin Studio and open ModelFileManager.sln in the ModelFileManager folder.
	5. Select Build All from the Build menu.

	

Designed and Written by
------------------------
Joseph Wezensky
joewez@gmail.com
Created June 23, 2015
Updated July 20, 2015
"Ported" To Mono/GTK August 7, 2015
Updated August 13, 2015