Read Me

*********************************************************************************
***                               AlarmeJT                                    ***
***    AlarmeJT is designed to work with exellent WSJT -X Joe Taylor, K1JT    ***
***    running on JT65A, JT9 and FT8 modes.                                   ***
***    -------------------------------------------------------------------    ***
***    version : 0.8 UDP beta 64 bits                                         ***
***    -------------------------------------------------------------------    ***
***    Copyright 2017 Alain Thébault (F5JMH)                                  ***
***                                                                           ***
***    This file is part of AlarmeJT.                                         ***
***                                                                           ***
***    AlarmeJT is free software: you can redistribute it and/or modify       ***
***    it under the terms of the GNU General Public License as published by   ***
***    the Free Software Foundation, either version 2.0 of the License, or    ***
***    any later version.                                                     ***
***                                                                           ***
***    AlarmeJT is distributed in the hope that it will be useful,            ***
***    but WITHOUT ANY WARRANTY; without even the implied warranty of         ***
***    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the          ***
***    GNU General Public License for more details.                           ***
***                                                                           ***
***    You should have received a copy of the GNU General Public License      ***
***    along with AlarmeJT.  If not, see <http://www.gnu.org/licenses/>.      ***
***                                                                           ***
***    -------------------------------------------------------------------    ***
*********************************************************************************

Who may use AlarmeJT ?
-----------------

Amateur radio operators using Linux version of WSJT-X, a software for JT65 and JT9 digital modes traffic.


Description of AlarmeJT
----------------------

AlarmeJT is a program written in Pascal, developed with Lazarus IDE for Linux.
It is designed for Linux Ubuntu, which is based on Debian. AlarmeJT is a plugin program
for WSJT-X, a JT65 and JT9 modes decoding software designed by Joe Taylor K1JT, the only
Linux software for this mode (Thanks to the WSJT team). AlarmeJT has its own 
logbook, fetches the information on the ongoing contact, manages unconfirmed DXCC 
alerts on the current band, the uncontacted grid square locators on the current band, 
as well as theFrench department, the Oblasts of countries using them (Russia, Ukraine ...) 
and the US States, still on current band.

AlarmeJT currently only allows visual alerts ..

A cluster (HamQTH.com) is available, as well as access to HamSpots of VK3AMA.


historic
--------

First developed in PHP to meet my personal needs in order to overcome the absence of such software in Linux, I was inspired by the excellent JTAlert of VK3AMA to develop an application able to give me similar alerts. Working with PHP at this time, 
I thought it wise to use this language. The problem was the data base. Architectured around MySql, in order to have a direct view of my logbook, it was hardly portable. This is the reason that led me to develop 
a version that can be both easily distributable and installable without seeting up a Web and MySQL server. My choice fell on Lazarus and SQLite3.


INSTALLATION
------------

prerequisite :

On Ubuntu, download the archive and unpack it in your /home/your_folder to obtain a /home/your_folder/AlarmeJT/.

If all goes well you will find in this folder the following subfolders :

/home/your_folder/
	|-------AlarmeJT/
			AlarmeJT (executable file)
			Readme et Lisez-moi
			Licence
		|-------init/
				AlarmeJT.ini
				cluster.jmh
				haminfo.jmh
				decodeloc.jmh
		|-------html/
				contains the help files (11 files).
			|-------img/
				contains help images.
		|-------lang/
			|-------EN/
				contains english language files (1 file).
			|-------FR/
				contains french language files (1 file).
		|-------sqlite/
			contains databasess*	
		|-------import/
			libsqlite3.so and its licence


The "import" folder contains the library for operating
SQLite3 : libsqlite3.so . This file has to be copied in /usr/bin .

You can create a shortcut on your desktop and/or create an entry with the Ubuntu menu editor. 
Please refer to the Linux aid to do this.

-------
After this, if your database is not work, please verified if you SQLite is ok on your system. If not
install SQLite3 with this in your terminal :

sudo apt-get install sqlite3 libsqlite3-dev

Thank's
-------

USE
---

From the terminal command line, type AlarmeJT. On first use, go to AlarmeJT->Preferences->General and enter your callsign and your Locator. 
If you have an account at HamQTH.com, enter your password that will serve to retrieve contact information.

IMPORTANT: You MUST start WSJT-X before launching AlarmeJT.

For more tips, please refer to the AlarmeJT help.


PROBLEMS ?
----------

If case of problem or bug, you can contact me on SourceForge.net at adress :
https://sourceforge.net/p/alarmejt/discussion/


Thank you for downloading AlarmeJT, wishing you will enjoy using it.


**********************************************************************************************
SQLite : SQLite is a software library that implements a self-contained, serverless, zero-
configuration, transactional SQL database engine. SQLite is the most widely deployed SQL
database engine in the world. The source code for SQLite is in the public domain.

Please visit : https://www.sqlite.org/
**********************************************************************************************