The goal of this project was to create a web server transmitting messages and an Android app replaying those messages on subscribed devices in morse code. This would serve as a modern equivalent of the wireless telegraph transmitters/receivers of old. It was comissioned for a summer camp in 2019.
This repository contains the client portion of the project as well as general documentation. Go to the lrdb-server repository to learn specifically about the project's server side.
This project is no longer maintained. Some modifications may be necessary before it can be run successfully. If you intend on using this software, make sure all dependencies are up to date to protect yourself against security vulnerabilities.
Do not try to build the app directly from this source. It doesn't contain all the necessary source files, for example the Google API key needed for proper function of Firebase, and some configuration strings were intentionally obfuscated. You can download a packaged binary from the Releases tab.
While the source code itself is in English, due to narrative concerns, all resource strings are in Italian. Their function should hopefully be identifiable from the resource names and their surrounding context in the code.
Once you download the app, open the home screen and subscribe to the message channel (Inizia ad ascoltare). When subscribed, make sure you have your ringtone volume turned up so you can hear the messages.
When the client receives a new message from the server, it vibrates, alerting the user a new message is incoming. Then it plays the received message twice, with a short jingle indicating the beginning and end of each message.
If you wish to stop receiving messages, you can unsubscribe on the home screen (Smetti di ascoltare).
The application also comes with a morse code cheat sheet and a handy morse code notepad, both accessible through the sidebar.
You can find the developer documentation for the project in the Wiki