Your most anticipated releases, in one place.
Built for Nextcloud, this app keeps all your data fully private. Your events and most anticipated releases stay exclusively on your instance โ no tracking, no profiling, no third-party access.
- ๐ Hyped Tracking: Manage countdowns for games, movies, series, and personal events.
- ๐ Dashboard Widget: View all your upcoming releases directly on your Nextcloud Dashboard.
- ๐ Smart Recurrence: Repeat events daily, weekly, monthly, or yearly (perfect for weekly show releases!).
- ๐ Stay Notified: Receive automatic alerts via Nextcloud Activity and System Notifications when a timer expires.
- ๐ผ๏ธ Dual Layout: Switch between Stacked (compact) and Grid (side-by-side) views to fit your style.
- ๐ฑ PWA Ready: Install the app on your phone or desktop for a native-like, full-screen experience.
- ๐ป OCC Integration: Administrators can manage countdowns using the OCC command line interface.
- โ๏ธ Custom Completion: Choose between default, random, or custom messages when a countdown finishes.
- ๐๏ธ News Center: Stay updated with the latest features and changes directly inside the app.
- ๐ฎ Easter Eggs: Discover secrets hidden inside the app inspired by pop culture!
ย ย ย ย
ย ย ย ย
You can find Countdown directly in your Nextcloud instance:
- Log in to your Nextcloud as an Administrator.
- Click on your profile icon (top right) and select Apps.
- Use the search bar to look for "Countdown".
- Click Download and enable.
If you prefer to install it manually or want to use a specific version:
- Download: Get the latest release from the GitHub Releases page or the Nextcloud App Store.
- Extract: Unpack the
countdown.tar.gz(or clone the repo) into your Nextcloud'sapps/directory. - Permissions: Ensure the folder permissions are correct (usually
www-datafor Linux servers).chown -R www-data:www-data /path/to/nextcloud/apps/countdown
- Enable: Go to the Apps section in your Nextcloud and click Enable on the Countdown app, or use the command line:
sudo -u www-data php /path/to/nextcloud/occ app:enable countdown
- Name & Date: Simply click the "+" button, enter a title (e.g., "GTA VI Release"), and pick the target date and time.
- Add some Magic: You can choose a custom emoji to represent your event and add a description for more details.
- Go Recurrent: Enable the Repeat toggle if you want the countdown to restart automatically (Daily, Weekly, Monthly, or Yearly).
- The Celebration: When the timer reaches zero, you'll receive a Nextcloud Notification and be greeted by a burst of confetti! ๐
The app ensures you never miss an event using two methods:
- Instant Notifications: If the app or dashboard widget is actively open in a browser tab or installed PWA, you get alerted the exact second the countdown ends (with confetti! ๐).
- Background Notifications: If the app is closed, Nextcloud's Background Jobs (
Cron) will notify you based on your server's schedule (usually every 5 minutes).
Note
All notifications are pushed globally across your devices! You will receive them not only in the web interface, but also via the Nextcloud Official Desktop Sync Client and the Nextcloud Mobile App.
First, ensure your Nextcloud instance is set to Cron mode (Recommended) rather than AJAX:
- Go to Settings > Basic settings.
- Under Background jobs, select Cron.
The app includes a background job that runs every 5 minutes, but you can achieve per-minute precision by adding a manual entry to your system's crontab. This ensures notifications arrive the exact second a timer expires.
To edit your crontab:
# For standard installations (e.g., Ubuntu/Debian)
sudo crontab -u www-data -eAdd the appropriate line for your setup:
| Environment | Frequency | Command |
|---|---|---|
| Standard / Bare Metal | Every minute | * * * * * php /path/to/nextcloud/occ countdown:check-timers |
| Docker Container | Every minute | * * * * * docker exec --user www-data nextcloud php occ countdown:check-timers |
| Nextcloud All-in-One | Every minute | * * * * * docker exec --user www-data nextcloud-aio-nextcloud php occ countdown:check-timers |
| Snap | Every minute | * * * * * nextcloud.occ countdown:check-timers |
Tip
Use crontab.guru to experiment with different schedules or to understand the cron syntax better.
Administrators can use the occ command line tool to manage countdowns and trigger notification checks manually from the terminal.
| Command | Purpose |
|---|---|
countdown:check-timers |
Manually trigger an immediate notification check for all users. |
countdown:list <user_id> |
List all active countdowns for a specific user (including IDs). |
countdown:add <user_id> <name> <target_date> |
Add a new countdown programmatically. |
countdown:delete <user_id> <id> |
Delete a specific countdown using its numeric ID. |
Example: Adding a countdown via Docker
docker exec --user www-data nextcloud php occ countdown:add "user_id" "Event Name" "2026-12-25 00:00:00"Note
Use the --help flag with any command (e.g., php occ countdown:add --help) to see all available options, such as setting emojis or descriptions via CLI.
To see your countdowns at a glance:
- Go to your Nextcloud Dashboard.
- Scroll to the bottom and click Edit widgets.
- Enable the Countdown widget.
If you find Countdown useful and want to support its development:
- Star the Project: Give us a star on GitHub to help others discover it.
- Leave a Review: Share your experience and feedback on the Nextcloud App Store.
- Support on Ko-fi: Help me keep the project active and always updated to the latest Nextcloud versions by buying me a coffee. โ
Your support helps me keep improving the app and adding new "magic" features! ๐ฆโจ
- Bugs & Features: Found a bug or have a great idea? Open an issue on GitHub Issues.
- Discussions: Join the community for questions and tips on GitHub Discussions.
- Source Code: Explore the code or fork the project at GitHub Repository.
This project is licensed under the AGPL-3.0-or-later license. See the LICENSE file for details.