/DayCounter

A simple Android app counting remaining days until a given date

Primary LanguageJavaGNU Affero General Public License v3.0AGPL-3.0

The original single-counter version (1.1) is still available in this branch and in this release.

DayCounter

A simple Android app counting remaining days until a given date. It was origianlly meant to give you a precise idea of how many days you have left until you reach a certain age (eg. 60 years), but you can use it for any sort of day counting.

I have been told that the code is a mess and it is hard to understand how it works (the fact that I already forgot it underlines that I guess), so I decided to make a small docs here.

Features

  • Unlimited number of counters (RAM is the limit)
  • Notification service displaying the amount of remaining days for any counter you choose
  • Homescreen widgets displaying the amount of remaining days for any counter you choose
  • Starts on boot
  • Supports complete translations (except for some error displaying and logging), currently available for 🇨🇿 Czech and 🇫🇷 French.

Notes

  • The app is tested to work on Android 10 when the user uses the app as intended, there may be bugs and undesired features which I will appreciate in Issues (and won't ever fix)
  • The UI sucks

⚠️ Saved data protection

The application stores the counters as a serialized data stream. Thus if you change the version of the Counter class (update/downgrade), it will be no longer possible for the application to load the data (the counters).

You can use the export and import functions to overcome this shortcoming by exporting the data in JSON format. Keep in mind that the byte format (the serialized data) can not be imported if the application uses a differnet version of the Counter class.

The JSON import/export option should be always prefered over bytes.

Items For Mental Consultation

How to build

Seriously, I have no idea

Build in Sketchware

See Releases and pick the file with .swb extension. It is a Sketchware backup file and you can use it to import this application as a Sketchware project. Be sure to use Sketchware Pro as I used several features the original Sketchware app does not offer.

Credits

I stole the icon from Icons8

Examples

Example 1: How many days until I reach 60?

When the app asks you for your birth date, be sure to enter the birth date and in the age box type '60'. dc_timer_until_sixty_years

Example 2: How many days until it is 2 years from now?

Into the birth date form you enter today's date and into the age box you type '2'. Screenshot_20220401-104700

Screenshots

dc_app_preview dc_settings_preview dc_homescreen_widget dc_notification_counter