Todo Agenda - Calendar and Task widgets for Android

Todo Agenda is home screen widgets for your Android device. Each widget has its own settings and displays configured list of calendar events and tasks so that you can easily have a glimpse at your due, current and upcoming appointments.

Features

• No advertising. Free and Open Source.
• Displays events from your calendars and task lists for the selected periods in the past and in the future.
• Automatically updates when you add/delete/modify an event. Or you may update the list instantly.
• Select only the calendars and task lists that you want to see in the widget.
• Create several widgets, if you need. Each widget has its own settings, including layouts, colors, filters, selected calendars and task lists.
• Customize colors and transparency of different widget parts, of their texts and backgrounds.
• Scroll through the list of events. Use "Go to Today" button to return to today instantly.
• Customize the text size of the widget.
• Fully resizable widget with alternative layouts.
• Indicators for alerts and recurring events.
• Lock time zone when travelling to different time zones.
• Turn off Widget header, Day headers, event icons, Days from today, etc. and see only what you need.
• Hide duplicated events.
• Backup and restore settings, cloning widgets on the same or different devices.
• Android 7+ supported. Supports Android tablets.

Note on Tasks support: As there is no unified way to access tasks created in different applications, each application needs its own implementation. Currently supported:

• OpenTasks (by dmfs GmbH).
• Tasks: Astrid To-Do List Clone v.10+, Google Tasks can be used via it.
• Partially supported: Tasks of Samsung Calendar (looks like a deprecating feature...).

Collaborate

Want to contribute to the project? Start by translating the widget to another language or update existing translation at Translation project at Crowdin and be a part of the next release. :)

We are developing this application in public to bring you a tool that you want to use. Please feel free to open issues and provide pull requests. To get timely feedback we are also providing Beta versions, see Beta testing of ToDo Agenda.

App development is fun. And it's even more fun, when you have automated testing set up to show you how your code performs. ToDo Agenda has such automated tests, allowing not only to replay event timelines, shared by users and thus figure out problems and understand wishes. We can even see all the replayed timelines on an Android device (or an emulator), as this tests execution recording shows. Create a widget with a name ending with "Test replay" and Tests will start showing in this widget. Source code of these tests is in the repository also.

Troubleshooting after installation or an update

In a case the widget doesn't work properly even after this, please search, read and follow up on similar issues here. In particular, see these solutions:

• Buttons don't work.
• Refresh doesn't help showing new events.
• New recurring calendar events not showing.

Changelog

• "Text shadow" option added to Colors section with these values: "No shadow" (default, nothing changes for existing widgets), "Dark shadow" and "Light shadow". For simplicity the same shadow applies to all parts of the widget. #88
• Event details -> "Description" option added to show Calendar event Description. #78
• Added settings to limit maximum number of lines for an event's title and for details (i.e. for time, location and description). #109.

• Fixed "Default Time zone in app doesn't change, when Android System Time Zone changes".
• Fixed "Do not make all permissions mandatory".
• App converted from Java to Kotlin.

• Date range filtering extended with "Today and Tomorrow" option. This is different from the "One day" option as that hides events after current time on the next day, which is a bit confusing.
• Show based on keywords in a title option added, allowing to see events that have certain text included. In addition to existing option "Hide based on keywords in a title".
• Allow changing language of User Interface for Android 13+ in Android System Settings - Apps, see Per-app language preferences, #119

• Time-related library (Joda Time) updated in order to have up-to-date information about world time zones.
• Fixed filtering of all day events. Sometimes today's all day events disappeared. #89
• Text strikethrough for canceled calendar events. #94

How Text color is defined option added with these three values:

1. Auto text shading (Text shading (White, Light, Dark or Black) is set automatically based on background color)
   - new value, with which we don't need to have "Text shading" setting anymore (this will be default option for new widgets).

2. Manual text shading (Text shading should be set for each part of the widget)
   - this is what we had before this change.

3. Custom text colors (Text color should be set for each part of the widget)
   - this is another new value.

As a result, we have less settings by default, and more flexibility for those who need it.

• Different colors for Android system Dark theme option added for Android 10+.
  When this option is turned on, the widget uses different sets of colors for Dark and Light themes. Configured sets of colors are switched automatically following changes of the device-wide Dark theme switch.
  "Colors for Dark theme" are configured, when Dark theme is turned on. "Colors for Light theme" are configured, when Dark theme is turned off.

• All day tasks are supported.
• All day events placement option added. It allows to place All day events at the top or at the bottom of the day's entries.
• Show time for tasks that do have time set AND that are shown in the list according to their date and time. This means that time is not shown for All day tasks, and e.g. for overdue tasks that are shown Today.
• Fixed weird "??? DAY_HEADER" for Astrid Clone Tasks app.

• Support of "Tasks: Astrid To-Do List Clone v.10+" not only gives us another app to manage tasks, but also allows to see Google tasks in our widget and manage them via the Tasks app. Please note that this works only with "Tasks app v.10+" #2.
• Compact layout option added. When it's turned on, most of spaces between widget parts are removed.
• Dark theme support added for the Widget's Settings screens. Theme of Settings screens switches automatically with Android system-wide "Dark theme" switch. This feature works in Android 10+.

• This version is for Android 7+ only. Versions for older devices are still available e.g. here.
• Created "Date format preference dialog" allowing to select date format from several options (including hiding date completely) or define your own custom date format for use in a Widget header, Day header or an Event entry. Custom format allows any date patterns, described in the Android documentation plus "b" letter(s) can be used to have in the formatted text "Number of days to event" also. Three separate settings cover many user requests that we received during several years. Enjoy!
• Additional options for tasks filtering and ordering. "Task scheduling" option added allowing to define, what date gets main attention for a task. With two values:
  • Show tasks under date due (Due date gets main attention, and we are showing tasks at their due dates, where it makes sense).
  • Show tasks under date started (Start date gets main attention, and we are showing tasks at their start dates, where it makes sense).
• "Tasks without start and due dates" option added to allow changing placement in the list or hiding such tasks; with values:
  • Show at the end of the whole list (default option)
  • Show at the end of Today.
  • Hide.
• "Filters troubleshooter" option added to debug events filtering and ordering.
• "Restore settings from a backup" feature extended so that if the backup contains events (stored using "Share events and settings for debugging") than that events can be shown as a snapshot (e.g. for app problem investigation). Corresponding new "Lock list of events (Snapshot mode)" feature allows to switch between "Live data from real sources" (i.e. normal way to see events in the widget), "Snapshot as seen at the time, when it was taken" (Time machine), and "Stored snapshot shown at current time".

2019-12-01 v3.1.9 Hide duplicate events. Backup and restore

• Selected Calendars (Task lists) display order is determined by the order in which the calendars are selected. Items in the list are reordered immediately after selection or deselection. All selected items are at the top of the list now.
• Hide duplicates option added. Only the first event is shown, others are hidden. As written above, display order of Calendars and Task Lists is customized now, so a User can control, events fom which Calendar will be shown.
• Backup and Restore widget settings. Convenient for cloning settings to another widget on the same device. Good for moving widget settings to another device, but may require calendars selection adjustment in this case.
• Removed unneeded vertical bar before location (when time is not shown, e.g. for all day events).
• Multiline details option added, allowing to see the whole Location in the "Time below title" Event entry layout.
• Improved automatic widget refresh via introduction of a configurable Auto refresh period (in Other Settings). Default Auto refresh period is 10 minutes.

2019-10-05 v3.0.11 More colors and layout customizations

• One "Appearance" Settings section split into: Layout, Colors and Other settings.
• Old and confusing Android Holo ColorPicker is replaced with a customized version of HSV-Alpha Color Picker for Android.
• "Widget header layout" option added with two actual layouts ("All in one row" and "Two rows layout") and one "Hidden" layout. This replaces and extends previous "Show widget header" checkbox.
• "Widget header background color" added.
• "Go to Today" button added to the Widget's header to ease navigation to Today's events.
• "Today's events background color" option added, so Today's events may be visually highlighted.
• "Day text header shading" added. Now the Day header color can be changed independently from "Event entry text shading".
• Different text shading for past / today's and for future Day Headers and (separately) for Events. The app hides color settings that are not actual. "Past events" section is removed completely if no past events may be shown and no task sources selected.
• "Show event icon" added, allowing to hide calendar's color bars and tasks icons.
• "Show number of days to event" option added (in the "All in one row" event layout) allowing to hide this info independently from the "Show day header" option.
• Horizontal lines (separators) are now above Day headers, not below them to avoid Users' confusion. However, we have a new option "Horizontal line below Day header" that allows to restore previous lines placement.
• Text size scaling improved - Now size of text in all parts of the widget changes, when you change "Text size" option.
• Don't show time for All day events.
• Display location independently of time, including showing location for All day events.
• Added more values to "Show events that ended recently", up to one year.
• Added "Show date on widget header" option so you can hide the date.
• 32 language translations updated and 5 new translations added! Thank you all!
• Hopefully fixed intermittent "No events" display instead of actual list of events. Separate "ToDo Agenda Not Initialized yet..." layout added to see the widget, when it is not initialized yet (e.g. after device reboot).

2019-08-11 v2.1.1 Tasks support

• Tasks support added. Two Task apps are supported: OpenTasks (by dmfs GmbH) and Tasks of Samsung Calendar (looks like a deprecating feature...).
• New option "Header for past/due events". If turned on, it shows all past/due events under one "Past and due" header. Applied both to calendar events and to tasks.

2019-01-19 v2.0.1 Renamed and republished

• The "Calendar Widget" renamed to "Todo Agenda" and published to Google Play as the new application. More details: No longer in Google play?

2017-06-01 v1.10.1

• Fix issue where widget would crash because of unexpected widgetId
• Translations updates

2017-05-02 v1.10.0

• Added: Different settings for different Widget instances allow you to create any number of customized views of your events, including configuration of different calendars for different widgets. All setting are separate for each Widget instance. In order not to get confused in configurations of different widgets, you can launch "Calendar Widget" with your Android Launcher and you will be presented with a widget selection list. Each widget can be given its name to ease configuring. See screenshots.
• Added: "Show day headers" option to disable day headers completely.
• Added: The alternative widget layout: "All in one row". Each event can now occupy literally one line only. "Appearance -> Event entry layout" option allows to switch between the "Time below title" layout and this new one. When used with the "Show day headers" option, this layout almost doubles number of events visible in a widget without scrolling. "Days from Today" column replaces day headers in a case the Day Headers are turned off. See screenshots.
• Added: "Abbreviate dates" option allows to have shorter date format for both Widget and Day headers.
• Added: "Lock time zone" option to show events in the same Time Zone when travelling to different time zones.
• Added: "Show only the closest instance of a recurring event". You can set "Event Filters"->"Date range" to "One year", and your agenda won't be an endless list of the same events.
• Improved: Use space or commas in "Hide based on keywords in a title". Place a text in single or double quotes in order to have space or comma in a filter.
• Android 7 compatibility, including support of permissions introduced in Android 6.

2015-11-01 v1.9.3

• New preferences to filter the events shown by the widget
  • New "Show events that ended recently" option allows to show events, which ended several hours ago, today or yesterday. #122
  • New "Show all past events having default color" option shows all past events, which have 'Default color'. This option may be used to treat calendar events as Tasks and mark their completion by changing event's color. #138
  • New "Hide based on keywords in a title" option, which acts on all events. Multiple keywords may be separated by spaces or commas.
• Add "Past events background color" option.
• Add "Today" option to "Date range", so you can see current and future events for today only (The same "Today" option exists for past events also) #156
• Add "Refresh" button to widget header to refresh the list of events #120
• Add "Show days without events" option
• Date format "auto" now makes use of system wide date settings

2015-01-20 v1.8.6

• Add styling for Android 5.0 (Lollipop)
• Adding widget to home screen instantly adds it without showing settings ui
• Add launcher entry to more easily access the settings of the widget
• Add support for new languages swedish, ukraine, vietnamese, traditional chinese and finish (thanks to all contributors)

v1.8.5

• Fixes problem where all day events would be shown one day off

v1.8.4

• The calendar selection preferences now show the account a calendar comes from (thanks @thknepper)
• Fixes issue where the date shown in the widget and in a calendar app would deviate (thanks @schmaller)
• Adds translation for Portuguese, Romanian and Greek
• Updates several other other translations

v1.8.3

• Adds Korean translation
• Fixes problem where the Norwegian translation was not visible to users

v1.8.2

• Updates translations and adds support for simplified Chinese, Bulgarian and Norwegian

v1.8.1

• Fixes issue where the date headers for "Today" and "Tomorrow" where not show correctly
• Updates translations and adds partial support for Hebrew (thanks bomba6)

v1.8

• Adds option to align the date header left, right and center
• Allows to show events spreading over multiple days only on the first day
• Enables to show only events in a one day date range (thanks jganetsk)
• Adds new translations in Dutch and polish
• A big thanks to at all the people who have helped with translations on crowdin.net blancazert, deamn, emes2, gabrielemariotti, hermajan, jagoda1-72, k.schasfoort, moritzpost

v1.7.2

• Fine tunes the shading of the text colors
• Fixes tinting issue of background color

v1.7.1

• Fixes critical bug on Android 4.0 devices
• Completes Czech translation (thanks hermajan)

v1.7

• Adds theming capabilities to the widget background and texts
• Taping on current date header now opens calendar app
• Calendar events can now show their event specific color

v1.6.4

• Updates Czech translation
• Fixes critical bug on Android 4.4

v1.6.3

• Adds support for multiple languages: Spanish, French, Italian and Brazilian Portuguese
• Adds option to hide end date (contributed by ultraq)
• Background transparency is set in 5% increments instead of 10% (contributed by ultraq)
• Fixed bug where events starting or ending at midnight would not show their time correctly

v1.6.2

• Fixed serious crash when preferences from older installations were present

v1.6.1

• Fixed a crash of Samsungs S Planner when creating new event

v1.6

• Added option to show the event location
• Added option to span title over multiple lines
• Added ability to choose from more font sizes
• Added option to set the event date range

v1.5.2

• Added support for Hungarian and Russian language

v1.5.1

• Added support for Czech language
• Fixed crashes when adding event on certain devices
• Fixed issue with spanning events

v1.5

• Enabled support to place the calendar widget on the lock screen
• Calendar events can now be added directly from the widget
• Added Japanese translations (Thanks to Sakuma)
• Fixed several stability issues

v1.4

• Fixed critical issue where an all-day event would be displayed one day to early in certain timezones
• Added ability to configure the transparency of the widget background

v1.3.2

• Added support for custom event colors
• Calendar colors are now correctly shown on Jelly Bean
• Fixed issue when opening the calendar selection preference activity
• Fixed problem with events that span multiple days

v1.3.1

• Fixed problem where noon was display as 0:00 pm instead of 12:00 pm
• Fixed issue when no calendar is present on the device

v1.3

• Added support for the am/pm date format
• Events that span multiple days now create multiple entries in the widget
• Touching a calendar entry now provides visual touch feedback
• Events without title now indicate that there is no title

v1.2.1

• Fixed issue where the date in the calendar app would be displayed wrong when opened from the widget

v1.2

• Added indicators for events with an alert
• Added indicators for recurring events
• Widget refreshes at midnight
• Widget handles time, date, timezone and locale changes correctly

v1.1

• Added preferences menu
• Added option to select the active calendars for the widget
• An new preferences option allows to hide the current date header to have more space for the calendar entries
• The text size can not be customized as small, medium or large
• The widget can not be shrinked properly on all devices

2012-05-15 v1.0

• Initial Release