Development

Would you like to help us make SleepyHead better?

Current development efforts are being organised at SleepyHead’s Discord server. If you are interested in joining in and helping with testing, fixing bugs, writing documentation or translation, please contact a team member for an invite: Discord SleepyHead channels.

Building from source

Obtaining Source Code

Official GIT master branch is at: http://gitlab.com/sleepyhead/sleepyhead-code

Windows Platform Build Notes

Recommended GIT client: http://git-scm.com  (When prompted install git binary to path (not everything, just the binary))

Requires Qt 5.11 to build, recommend Qt 5.11.0

The Qt OpenSource SDK is available from https://download.qt.io/official_releases/qt/5.11/5.11.0/qt-opensource-windows-x86-5.11.0.exe (Expect more than 2,5 GiB)
(Install 5.11.0, MinGW 5.3.0 32 bit, and Sources, and Qt Creator 4.6.1 plus MinGW 5.3.0 compiler under Tools)

If you really want to debug (step through, breakpoints, etc) code, It’s ok to install/also install  Qt5.5 from Qt.io’s installer (which has webkit included), but it means putting up with a few odd unexpected crashes and Qt bugs.  Make sure to pull it’s relevant Toolchain and source if you do.

Mac Platform Build Notes

Requires XCode and CommandLine Tools installed from Apple’s App store.

Requires Qt5.8+ to build on latest MacOS and XCode  (this means it requires Annulen QtWebkit revival fork built)
https://github.com/annulen/webkit/wiki/Building-QtWebKit-on-OS-X

This was way easier than building on windows for some reason.

Recommend using official Qt5.9.4 build (from http://qt.io/download) and building QtWebkit to suit. (https://github.com/annulen/webkit)

Linux Platform Build Notes

Requires Qt 5+ with webkit, package manager version will do, recent Debian systems (and others) have QtWebkit in the package manager along with reasonably modern Qt5 builds.

Reporting Bugs

Bug Reports (for GIT MASTER SOURCE CODE BUILDS ONLY please):
https://gitlab.com/sleepyhead/sleepyhead-code/issues 

(and please no feature requests on gitlab issues, but feel free to come discuss them in the ideas room on discord chat)

Duplicates or two-fers will be deleted mercilessly and with fervor. Please make sure to include ALL your relevant information unless you are the one who is going to fix it (and remember others help test too even then)… Don’t assume anyone else knows what equipment, type of computer you are running, and don’t use Mark’s lazy bug reports as an example.

Make sure to git pull the latest code and retesting before filing your report.

Translating

In 2013 Arie Klerk started translating SleepyHead into Dutch, his native language. Soon other languages followed. You can switch language under Help/Change Language.

If you find anything that is not translated correctly, please contact Arie Klerk, who is the official coordinator for all translations of SleepyHead; he will gladly bring you in contact with the translator.

Of course still many languages are missing. If you have got the time, and are reasonably fluent with the medical terms used in SleepyHead in both English and your native language, and want to help out with translating, please let Arie know. The tool used for translation work is a free app called Qt Linguist, and it’s fairly straightforward to use. No programming involved, but you’ll still need to know how to find your way around your computer. You will need the translation template for your language and the program. Qt Linguist can be downloaded from here: http://www.softpedia.com/get/Others/Home-Education/Qt-Linguist.shtml.