﻿Release 2019.07.05.1842:
- The hidden and special program function in the context of the file "mute_scheduler[-ACCOUNTID].csv",
  which was introduced with the release 2018.11.27.1918, has been  removed again.
- As a precaution against new experiments from the developers of the russian frn servers, who add
  sometimes new fields to their server responses, xStream.ignoreUnknownElements() has now been set.
- In the program settings - if gateway mode is selected - the file name of a script can now be
  specified in the field "LCD Display Script", which controls the display of transfered data on a
  connected LCD display. For example an I2C LCD display on a Raspberry Pi.
  Two parameters as quoted strings are passed to the script: 'Line1' and 'Line2'.
  The script is currently called at the following program events: When connecting, in case of 
  connection errors, while receiving (every sec), while sending (every sec), when changing the
  QRV/QRL/QRT status and when disconnecting.


Release 2019.07.04.1548:
- Adaptation to additional fields provided by the current alterFRN server in response to a CT request.


Release 2019.07.04.1448:
- The connection problem in the context with FRN server addresses consisting of only an IP address
  (no hostname) has been solved.


Release 2019.06.29.1142:
- The current development version (2019.06.29.1116rc) becomes the new stable version.
- The expiry date of the program has been adjusted.


Release 2019.06.29.1116rc:
- An update regarding error #0981.


Release 2019.06.25.1702rc:
- Tooltip windows at the input fields of the following setting parameters:
  AudioInPreCapturedTime, RadioCarrierCatchTime, RadioCarrierLostTime, RadioCOS, RadioCourtesyDelay,
  RadioCTCSSWakeTime, RadioPTT, RadioSquelchSettlingTime, RadioSquelchSettlingTimeIn
- Minor corrections in messages_fi.properties
- frnconsole-default.cfg.unix: Default value of parameter EnableMicAudioLevelDisplay changed from
  'yes' to 'no'.


Release 2019.06.17.1410rc:
- Language Support for Portuguese (Brazil) has been added.
  Many thanks to [PU2CRC, Renato] for the portuguese translation of the messages.properties file.


Release 2019.05.09.2026rc:
- Implementation of the operating modes FRN Gateway and FRN Crosslink.
- An error message is now displayed when the subprocess detects an error with the audio capture device.
- Error message regarding error #0981 extended with a hint of cause.


Release 2019.03.26.1642:
- Fixed a typo in the string value of a program internal constant (regarding the name of the 
  executable file under Linux i386).


Release 2019.03.25.1402:
- Fixed a typo in the string value of a program internal constant (regarding the name of the 
  executable file under FreeBSD i386).


Release 2019.03.21.0954:
- Precautions against the pointless action of some users, clicking on the connect button without
  the minimum required program settings.


Release 2019.03.10.1306rc:
- New optional parameter in the client.properties file: "frnClientDescrIncludesReleaseInfoPrefix"
  The program's interal default parameter value is "true". The value "false" can be used to suppress
  the automatically inserted release info prefix in the client description field.
- Individual settings of the In-/OutSampleRate are now correctly considered. (Previously, the program's
  internal default values were always used.)
- An error message dialog is displayed if the executable subprocess file cannot be found.
- An update regarding a possible error #0981.


Release 2019.02.27.1054rc:
- Current r5564 releases of Valerys FRNClientConsole integrated.
  * FRNClientConsole.Win32.r5564.exe
  * FRNClientConsole.Linux-armhf.r5564
  * FRNClientConsole.Linux-i386.r5564
  * FRNClientConsole.Linux-amd64.r5564
  * FRNClientConsole.FreeBSD-i386.r5564
  * FRNClientConsole.FreeBSD-i386.r5564
- New possible parameter values for the parameter subprocess_impl of the client.properties file:
  * Linux-armhf
  * FreeBSD-i386
  * FreeBSD-amd64
- Additional fixes regarding the rarely issue with the talk time display in RX mode.


Release 2019.02.17.1052rc:
- Current r5556/r5554 releases of Valerys FRNClientConsole integrated including various adaptations
  regarding the meanwhile changed outputs on stdout from its executables.
  * FRNClientConsole.Win32.r5556.exe
  * FRNClientConsole.Linux-armhf.r5556
  * FRNClientConsole.Linux-i386.r5556
  * FRNClientConsole.Linux-amd64.r5554


Release 2019.02.15.1048rc:
- The display of the call duration in RX mode implemented in program release 2019.02.09.1032rc
  showed the very rarely effect of continuing although the program is no longer in RX mode. 
  This has been fixed now.
- Further preparatory adaptations to the upcoming new version of Valery's FRNClientConsole.


Release 2019.02.09.1032rc:
- In the TX/RX status line, the current talk time in seconds is now also displayed in receive mode.
  (Previously only the total time was displayed at the end of the transmission.)
- Complete refactoring of the implementation of the FRN monitor view (on the left side of the 
  FRN client window) in particular including the following changes/improvements:
  * The effect that some monitor lines were sometimes only displayed shortened with "..." at the
    end of the line does not occur anymore.
  * Server and client lines of FRN servers or FRN clients running my software are now displayed
    in a different font color (dark blue).
  * Performance optimization regarding the display of the TreeView (also when refreshing the
    monitor list).
- Display (Field Fore- / Background Colors, Focus Highlighting, Selection Marking, Enable-/Disable
  Visualization) of all ComboBox fields and the Port Number field has been reworked. 


Release 2018.12.27.1602:
- A documentation regarding the configuration parameters has been added to the software package.
- Final build for first public deploy


Release 2018.12.12.1902:
- Socket timeout in ClientConnector increased.


Release 2018.12.10.0024:
- A few corrections regarding the Finnish language mode.
  Thanks again to SG3FTR (BERTTA, Mika) for helping with the translation to Finnish.


Release 2018.12.09.1730:
- A first implementation of a MultiLanguage support of the program. Currently the languages
  English (default), German and Finnish are supported. Special thanks to SG3FTR (BERTTA, Mika) for
  helping with the translation to Finnish.
  Please note: A change of the language setting only takes effect after restarting the program !
  If you like to have other languages to be supported, please download the attached 
  message.properties file and send it back to me after translation. The file name of the translated
  message.properties file should correspond to the sample "message_{locale}.properties" with
  {locale}=your Locale abbreviation (for example "it"=Italian, "fr"=French, etc...). Please 
  translate only the strings to the right of the equal signs. If possible, the translation of the
  strings should not be much longer than the english default. 


Release 2018.11.27.1918:
- The input field "Server" is no no longer a simple text input field but now a so-called ComboBox
  input field with a selection list of all the servers you have already connected to.
  The selection list is constantly updated and is sorted by server name. It is saved at program
  end and also re-loaded at program start.
- A hidden and new feature: A hidden feature because the configuration cannot yet be done via the
  "Settings" tab, but only by manually editing a separate CSV file.
  This new feature offers a scheduler controlled muting of clients in a server room !
  The file name of the configuration file is build according to the following pattern:
  "mute_scheduler[-ACCOUNTID].csv"
  The program searches and loads the file at program start from the subdirectory "subprocess".
  As a reminder: The optional ACCOUNTID is the identification which can be used to distinguish
  between several own FRN accounts when starting the program via command line parameter "-id ...".
  The configuration lines in the CSV file (field separator is semicolon!) are structured according
  to the following pattern:
  "operatorName";"on/off";"cronExpression"
  Here is an example content of this file:
  "CALLSIGN, Name"; "on"; "0 0 23 * * ?"
  "CALLSIGN, Name"; "off"; "0 0 3 * * ?"
  This means that the FRN client with the operator name "CALLSIGN, Name" (no matter if "PC Only",
  "Gateway" or "Crosslink") will be muted every day at 23:00 o'clock and will be enabled again at
  03:00 o'clock.
  The Cron Expression follows the usual syntax of Cron Expressions (similar to the linux crontab)
  and therefore offers many possibilities to specify the desired time points.
  Prerequisite for the execution of these mute/unmute jobs:
  The FRN_Client with the scheduler jobs configured in this way must be connected to the 
  corresponding server room at the time a job is executed and must have at least ADMIN rights.
  (As you know, the Mute function is only available to clients who have OWNER, NETOWNER or ADMIN
  rights.) And of course the client, which should be muted/unmuted, must be online at that time.


Release 2018.11.25.1522:
- An update regarding possible error #0981.


Release 2018.10.28.1534:
- Because the server change in server backup mode sometimes did not work as expected:
  * Source Code Refactoring in several Java classes involved.
  * The logging in the participating class methods has been revised and extended.
  * Fix of a conditionally possible NullPointer exception in method __stopSpeakingTimeTimer(),
    which as a negative side effect also interfered / prevented the return to the main FRN server.
    This error constellation was quite difficult to find.
- Preparatory adaptations to the upcoming new version of Valery's FRNClientConsole.


Release 2018.09.20.1432:
- BugFix regrading the password request (FRN User registration), if it was sent to the original
  FRN system (SysmanEU selected).
- The main parameters of the recorder function of the subprocess are now also taken into account
  in the program settings. 


Release 2018.09.14.1518:
- In TX mode, the duration of the speaking time is now displayed in the lower status bar also 
  during the running voice transmission.
- The AGC functionality on the audio output channel is not compatible with the silent voice packets
  sent by the Java FRN_Server when the FRN client is in QRT mode. Therefore this optional setting
  has been removed again for the time being.


Release 2018.09.13.1724:
- The format of the time column of the text messages table is now "dd.MM.yyyy HH:mm:ss".
- All internal Timer and TimerTasks of the program have been reworked (including minor bugfix 
  regarding the speaktime timer).
- A change of the Q-status (QRT, QRL, QRV) during a running connection is now also maintained at  
  a program-controlled change between main and backup server.
- The value of both parameters InQuality and OutQuality has been changed from "M" (=medium) to
  "H" (=high).
- The value of the CarrierLostTime parameter has been changed from 0 to 150 ms.
- The value of the parameter InPreCapturedTime has been changed from 0 to 150 ms.
- The settings of both parameters InAGCEnabled and OutAGCEnabled can now be changed under "Settings".
- The progress bar of the audio level test now shows also the actual audio level reported by the
  sub-process. In preparation for a possible future feature enhancement: Selecting a suitable VOX
  level for a future crosslink or gateway operation mode of the Java FRN_Client ...


Release 2018.09.02.1538:
At the suggestion of a beta tester, the PTT keyboard shortcut has been changed from "Numpad+" to
"RightCtrl". However, because in the KeyBinding procedure, which is recommended and usually is used
for such keyboard shortcut implementations, the KeyEvent.KEY_LOCATION_RIGHT is unexpectedly not taken
into account (seems to be a bug in the java runtime), a separate KeyListener had to be implemented. 


Release 2018.09.01.0116:
An update regarding error #0981.


Release 2018.07.29.1924:
- The timer for speaking time controlling is now triggered not at "Carrier ON" but at "TX is approved 
  and started" and will be resetted even in case of unexpected transmission interruptions or
  unexpected connection terminations. If required, this timer can be set in the client.properties
  file to a value other than the default value 150 using the parameter "time-out-timer" or switched
  off completely (time-out-timer=0).


Release 2018.07.28.1854:
- The detection and handling of possible peer disconnections through the internal MITM proxy pipes
  has been revised and optimized.
- Source code refactoring (especially regarding MitmFromServerToClient and MitmFromClientToServer)
- If the speaking time exceeds 150 seconds, a local warning tone sounds every 5 seconds.
- The column widths of the both tables tblClients and tblTextMessages is now also saved in gui.ini
  and restored at program start.


Release 2018.07.25.1432:
- Any tabs in text messages are now converted to spaces because the Original FRN Server (Edwin's
  implementation) cannot handle them.
- The algorithm for the variable row height of the text message table has been revised again: 
  In the current Java Runtime seems to be a problem with table.prepareRenderer(..) and/or
  comp.getPreferredSize().height. A WorkAround has been developed for this issue.


Release 2018.07.20.1436:
- On WindowStateChanged the SysTray menuItem "Show/Hide" will now be set accordingly.
- If used the account ID is now also displayed in the SysTray tooltip window.
- The field length of the input field "Description" will now be reduced by current length of the
  inserted version-info string.
- Now also showing TX and RX duration in the TX/RX status line.
- Logger messages reworked and log4j.xml changed.
- Minor bugfixes, source code refactoring and byteCode optimizing. 


Release 2018.07.12.2222:
- The last WindowState (such as ICONIFIED/MINIMIZED) is now also saved in gui.ini and restored
  at program start.
- Workaround for the effect, that Valery's subprocess does not support a change of the visible status
  on the fly. Due to this workaround no more reconnects after status changes are necessary anymore !
- On Windows operating systems, a possibly still running subprocess was searched for and terminated
  during program start. This function is no longer required and has also been removed for a possible 
  parallel execution of several program instances.
- Various program changes concerning the handling of the conguration files and the log files to enable
  the execution of parallel program instances with different FRN accounts. To use this new feature,
  specify when calling the program the new option" -id" after the name of the executable file together
  with a short identifier of the FRN account directly behind that option (separated by a space).
  For example, a sequential number or the call sign can serve as identification. In any case the 
  character string of the identifier must not contain any special characters, hyphens or spaces.
  The account ID is then also inserted as a suffix in the filenames of the affected configuration
  files (subproccess config file, gui config file), the COS file and in the filenames of the rolling
  log files. Thus, the account specific settings and log files can be distinguished.
  Here follows an example of the extended programm call:
  FRN_Client.exe -id ACCOUNT1   (on MS Windows operating systems)
  FRN_Client.run -id ACCOUNT1   (on Linux operating systems)


Release 2018.07.10.1652:
- BugFix regarding the saving of the OutSampleRate parameter.
- Because the subprocess doesn't handle it the right way (and Valery doesn't want to change it) the 
  transmitted voice packets are now muted in my MITM Proxy (ServerToClient) if the receiving client 
  has switched to QRT.
- The Handling of connection errors (f.e. in case of a wrong servername) has been improved.
- At the special request of one of the beta testers, a SysTray icon with linked context menu
  and tooltip has beeen implemented now.
- Mention of the most active beta testers on the "About" tab.


Release 2018.07.09.1554:
- At the suggestion of a beta tester, the field length of the SampleRate parameters was increased by one
  digit and the internal default values of the parameters InPreCapturedTime, CTCSSWakeTime, 
  CarrierCatchTime and CarrierLostTime were changed. (deactivated, because for PC_Only clients unnecessary)
- The problem with umlauts / special characters in the name of the audio interfaces has been solved.


Release 2018.07.07.1708:
No functional changes. Only the tab "About" with some information about the program and the authors
has been added.


Release 2018.07.01.1508:
- Removal of no longer needed library jar files.
- Source code refactoring and bytecode optimizing.


Release 2018.06.29.1642:
- On the "Settings" tab next to the configuration fields "Sound Courtesy", "Sound Roger" and "Hours Dir" 
  corresponding buttons and dialog windows for selecting the desired file respectively the desired directory
  have been added.
- The approach concerning the executable FRN_Client Starter file and the separate FRN_Client JAR file has 
  been changed again !
  For both operating system platforms - Microsoft Windows and Linux - a suitable executable Java Wrapper
  file will now be delivered, which already contains the corresponding current FRN_Client JAR file.
  The FRN_Client JAR file is no longer delivered separately. Possibly remaining FRN_Client JAR Files
  (from previous releases) should be deleted!
  Therefore, the classic java program call via command line using "java -jar FRN_Client.jar ..." can now 
  also be omitted on Linux platforms.
  The Java wrapper for Microsoft Windows operating systems is the file "FRN_Client.exe" -- the Java wrapper
  for Linux operating systems is the file "FRN_Client.run".
  On Linux only the executable flag of "FRN_Client.run" has to be set after the initial installation.
  This can be done with the shell script make_executable.sh, which has to be called on the terminal 
  commandline as follows: 
  sudo /bin/sh ./make_executable.sh


Release 2018.06.27.1548:
In the table display of the FRN textmessages, the auto resize (height/width) of the "Message" column 
has been revised and improved.


Release 2018.06.26.1426:
- The commandline options
  "-lp {filepath of the log4j.xml file}"
  and "-cp {filepath of the client.properties file}" 
  are no longer absolutely required, because they are now initialized with an internal default value.
- Further improvements of the dynamic application window, so that SplitPane dividers can be used even with
  very small screen resolutions.
- A minor bugfix regarding the disabling and enabling of the PTT button. The PTT button was wrongly reenabled
  even in QRT/QRL mode after receiving a voice transmission.
- After receiving a voice transmission, the shortcut key binding of the PTT button is no longer activated
  immediately, but with an 1 second delay. This makes the pressing of the PTT shortcut key - even before the
  reception of a running voice transmission is completed - practically ineffective ...
- The FRN_Client EXE file now only contains the starter for the Java program on Microsoft Windows platforms.
  The EXE file is no longer bundled with the FRN_Client JAR file. Future updates will usually not change
  the exe file, but only the JAR file.


Release 2018.06.18.1925:
Small bugfix regarding the recent change in the previous release. The "JClnt.EnableMicAudioLevelDisplay" 
option was not saved correctly in the cfg file due to a typing error in the section name.


Release 2018.06.18.1642:
Because the microphone level display in Java FRN_Client does not work on Linux without more ado (adjustments
in asound.conf), the display is now switched off by default. To activate this mic level indicator, the 
check mark "enable mic audio level display on main tab" must be set under "Settings".


Release 2018.06.17.1924:
- Microphone level now also displayed on the main tab!
- Long overdue corrections in the dynamic layout of the both tabs "Mute/Block List" and "Admin/Access List".
- Changed foreground and background colors of both status lines to improve readability in combination with 
  red or green background.


Release 2018.06.16.0425:
- Improvements in the MitmFromServerToClient class regarding the detection of EOF.
- The "Clear" function has been added to the context menu of the TextMessage table.
- A context menu with the "Clear" function has been added to the EventLog table.
- Added some "salt" to the configurable scramble key.


Release 2018.06.13.2038:
A Trial implementation of a voice scrambling function.
It only works between Java FRN_Client programs beginning with this release.
The scrambling is done with a configurable key, which must be set identically for all Java FRN_Clients involved.
To be able to use this program feature, it must at first be activated via client.properties file.
Please contact me if you are interested.


Release 2018.06.11.2146:
- The problem with German umlauts (ÄÖÜäöü ...) when sending FRN textmessages with the Java FRN_Client program
  on operating systems other than Microsoft Windows has been fixed.
- The "Settings" tab now also displays an info about the default charset.
- The context menu of the textmessage field is no longer displayed if the field is disabled.


Release 2018.06.11.1520:
- Because, contrary to expectations, the FRN EmotionIcons apparently cannot be displayed identically on
  all operating system platforms using Unicode characters, their visualization has been completely revised
  by using icon images files now.
- Intensiv source code refactoring regarding all used icon image resources.
- In the settings the selection of the SystemManager server address has been added!
  The default value is of course: sysman.freeradionetwork.de -- The Alternate FRN SystemManager Server.


Release 2018.06.10.1832:
- Important bugfix regarding the loading of configuration settings in connection with empty description 
  fields. Due to an unexpected exception, certain subsequent program lines were not executed, which led to
  strange effects.
- Refactoring of the module for sending FRN messages. Completion of the implementation regarding the display
  of HTTP(S) links and images links. The context menu on the Textmessage field has been extended by several
  menu items and corresponding procedures to support in addition to setting certain font styles also the 
  insertion of links and emotion icons.


Release 2018.06.08.1532:
- Small bugfix regarding access rights to Admin- and AccessList functions (A possible NETOWNER Status 
  of the user was not considered correctly in all affected constellations).
- The Starting/stopping of the subprocess and the respective parsers were made more robust and provided
  with additional logging.
- Dynamic layout of SplitPane panels have been revised again.


Release 2018.06.07.1626:
- One minor BugFix and some improvements of the GUI regarding the sending of private FRN textmessages
- panelNorth and panelSouth of the splitPaneVert (right side of splitPaneHoriz) completely reworked in
  order to display a narrow digital clock in vertical orientation
- Scheduled TimerTask implemented for the display of an accurate-to-second clock
- Tooltip Popup on message textfield regarding some html codes


Release 2018.06.04.0248:
- German hours sound files (created by Heiko, DAD379) have been added. The HoursDirectory is "hours/de".
- The release info is now automatically added to the client description.
- Some logger entries have been changed.
- A workAround has been found for the issue with the too small font scaling of Java 8 on 4K (HiDPI) displays.
  Therefore the previous fixed font size has been removed and the whole gui layout has been adapted again.
  Beside other things also the Table Cell Renderers, which display the different FRN symbols.


Release 2018.05.27.1452:
At the special request of a beta tester, the time announcement function has been made available.
In this context, the Settings Panel has also been equipped with scrollbars. For users, who only have a small
screen resolution. I was actually of the opinion that 4K screen resolution is standard today. ;-)


Release 2018.04.30.1834:
First official Beta Release