HatchKeeper

HatchKeeper is an open-source cross-platform program that keeps track of egg incubation. HatchKeeper currently runs on Linux, Windows and macOS. For more help see the HatchKeeper Manual. To file a bug report or if you have a patch, comment or question, see the forum and tickets on our SourceForge page or visit our homepage.

License:

See gpl-3.0.txt

Setting up on Linux:

HatchKeeper is now avalible as an AppImage. If this doesnt work for you, it is possible to extract HatchKeeper with ./*.AppImage --appimage-extract, this will work as a portable app or you can manually install it.

To use as a portable app just extract the AppImage and give HatchKeeper execute permission. Make sure that .HatchKeeper_Data_* has read and write permission.

Or Just copy HatchKeeper_ to /usr/bin and copy .HatchKeeper_Data_ to you home folder. Make sure you have the right permissions. run HatchKeeper_* to launch

NOTE: beginning with version 0.75.0 hatchkeeperd will no longer be available, use the built-in notifications instead.

Setting up on Windows:

HatchKeeper for windows is avalible as a portable app or an install.

For the portable version: Just run the self-extracting .exe file extract to the location of your choice. Double-click HatchKeeper.exe to run your app.

For the installer: Run the installer, then launch from the Start Menu.

Before uninstalling HatchKeeper on Windows, right-click the HatchKeeper icon notification area on the Taskbar and select Exit Completely before running the uninstaller.

Setting up on Mac:

On Mac right-click the .dmg installer. Select open and then select open in the warning dialog. In Finder drag HatchKeeper to the Applications shortcut in the same directory.

To uninstall, Navigate to /Applications with Finder, Right- Click HatchKeeper. Select Move To Trash.

To set HatchKeeper to start at login: Open HatchKeeper, right- click the HatchKeeper icon in the Dock, select Options > Start At Login.

Compiling HatchKeeper

Dependecies:

G++ and Make:

wxWidgets

wxFreeChart, You can manually specfiy NO_GRAPH and edit out the wxFreeChart library in the makefiles to eliminate the wxFreeChart dependency.

SQLite3

TinyXML2

On Windows:

Compiler

Download and install TDM GCC 10.3.0.

wxWidgets

You don't need to build wxWidgets on Windows if you use a supported compiler. wxWidgets 3.2.2 ships binaries and headers for TDM GCC 10.3.0.

Simply extract the wxWidgets binaries and headers into a folder and you are ready to build wxFreeChart.

If the binaries mentioned above do not work for you. You'll need to build a copy of wxWidgets 3.2.2. Extract source to a folder of your choice. Next open build\msw\config.gcc in a text editor and modify some lines to look like this:

# Standard flags for C++ 
CXXFLAGS ?= "--std=gnu++11"

# What type of library to build? [0,1]
SHARED ?= 1

# Type of compiled binaries [,release]
BUILD ?= release

# Should debugging info be included in the executables? The default value
# "default" means that debug info will be included if BUILD=debug
# and not included if BUILD=release. [0,1,default]
DEBUG_INFO ?= 0

# Value of wxDEBUG_LEVEL. The default value is the same as 1 and means that all
# but expensive assert checks are enabled, use 0 to completely remove debugging
# code. [0,1,default]
DEBUG_FLAG ?= 1

# Version of C runtime library to use. You can change this to
# static if SHARED=0, but it is highly recommended to not do
# it if SHARED=1 unless you know what you are doing. [dynamic,static]
RUNTIME_LIBS ?= dynamic

Next cd to build\msw\ and run:

mingw32-make -f makefile.gcc SHELL=CMD

wxFreeChart

Either git clone or download a zip of the latest wxFreeChart master, cd into \build and run:

mingw32-make -f makefile.gcc WX_DIR=..\..\wxWidgets-3.2.2 WX_VERSION=32  WX_UNICODE=1 WX_DEBUG=0 WX_SHARED=1 SHELL=CMD

Make sure WX_DIR points to your wxWidgets install. Once it builds copy the /lib/wxcode*.dll file to the root of the HatchKeeper source.

SQLite3

Download the latest amalgamation version of the source code, cd into it and run:

mingw32-gcc -c sqlite3.c

TinyXML

Download the latest version of the source code, cd into it and run:

mingw32-gcc -c tinyxml2.cpp

Configure HatchKeeper

Open WinMakfile in your text editor and edit the dependencies variables to match their locations on your computer:

#Dependencies
WXPATH := ..\wxWidgets-3.2.2
XMLPATH := ..\tinyxml2-8.0.0
SQLPATH := ..\sqlite3
CHARTPATH := ..\wxFreeChart

Finally build HatchKeeper by cd into the directory and run:

 mingw32-make -f WinMakefile SHELL=CMD

Copy the following files from wxWidgets\lib into the root of HatchKeeper source. Note: Filenames might be slightly different if wxWidgets is built from source i.e custom instead of gcc1030TDM.

wxbase32u_gcc1030TDM.dll
wxmsw32u_adv_gcc1030TDM.dll
wxmsw32u_aui_gcc1030TDM.dll
wxmsw32u_core_gcc1030TDM.dll
wxmsw32u_html_gcc1030TDM.dll

To build an installer you'll need to install NSIS and the AccessControl plug-in. Copy the HatchInstaller.nsi file from Platforms/Windows to the root of the HatchKeeper source and compile it with the nsis compiler, this will produce an installable .exe installer in the root of the source.

On Linux.

Install Dependencies

g++/gcc make libnotify-dev libsqlite3-dev libtinyxml2-dev libgtk-3-dev

wxWidgets 3.2.2

Download wxWidgets 3.2.2 Extract and cd into the wxWidgets source and run:

./configure --disable-shared
make
sudo make install

wxFreeChart

Git clone wxFreeChart, cd into the source and run:

./configure

Make sure the summary specifies wx 3.2.2 static than run:

make
sudo make install

Building HatchKeeper

Cd into source and run:

make

AppImage

To package as an AppImage you'll need to download the appimagetool. Copy the HatchKeeper executable and the HatchKeeper_Data_ folder to Platforms/Linux/HatchKeeper_v.AppDir. Cd into Platforms/Linux and run

chmod +x ./HatchKeeper_v*.AppDir/AppRun 
<path-to-appimagetool> -n ./HatchKeeper_v*.AppDir. 

The AppImage should be found in Platforms/Linux.

On Mac.

Assuming you have the Command Line Tools For Xcode Installed.

wxWidgets

Same as Linux.

wxFreeChart

Same as Linux.

SQLite3

Download the latest amalgamation version of the source code, cd into it and run:

gcc -c sqlite3.c

TinyXML

Download the latest version of the source code, cd into it and run:

gcc -c tinyxml2.cpp

Building HatchKeeper

Open MacMakfile in your text editor and edit the dependencies variables to match their locations on your computer:

#Dependencies
XMLPATH := ..\tinyxml2-8.0.0
SQLPATH := ..\sqlite3

And run:

make -f MacMakefile

The finished product will be called HatchKeeper.app. Copy this to /Applications to install.

Documentation

User Documentation

For user documentation, check https://hatchkeeper.sourceforge.io/help

Developer Documentation

HatchKeeper source is documented with doxygen. Make sure you have doxygen installed and run:

cd ./doc
doxygen ./Doxyfile

Open ./html/index.html with your favorite web browser.