{"id":48531296,"url":"https://github.com/infinit7even/countdown","last_synced_at":"2026-05-03T00:04:45.267Z","repository":{"id":348102467,"uuid":"1194952419","full_name":"infinit7even/countdown","owner":"infinit7even","description":"This application is designed to help you manage, track, and display modern, customizable countdown timers directly within Nextcloud","archived":false,"fork":false,"pushed_at":"2026-04-07T19:08:58.000Z","size":1526,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-07T20:25:11.207Z","etag":null,"topics":["nextcloud","nextcloud-app"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/infinit7even.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-29T02:49:39.000Z","updated_at":"2026-04-07T19:05:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/infinit7even/countdown","commit_stats":null,"previous_names":["infinit7even/countdown"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/infinit7even/countdown","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infinit7even%2Fcountdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infinit7even%2Fcountdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infinit7even%2Fcountdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infinit7even%2Fcountdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/infinit7even","download_url":"https://codeload.github.com/infinit7even/countdown/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infinit7even%2Fcountdown/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31533824,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nextcloud","nextcloud-app"],"created_at":"2026-04-08T00:01:05.884Z","updated_at":"2026-05-03T00:04:45.261Z","avatar_url":"https://github.com/infinit7even.png","language":"JavaScript","funding_links":["https://ko-fi.com/infinit7even"],"categories":[],"sub_categories":[],"readme":"# 🕒 Countdown for Nextcloud\r\n\r\n**Your most anticipated releases, in one place.**\r\n\r\n**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.\r\n\r\n## ✨ Features\r\n\r\n* 🕒 **Hyped Tracking**: Manage countdowns for games, movies, series, and personal events.\r\n* 📊 **Dashboard Widget**: View all your upcoming releases directly on your Nextcloud Dashboard.\r\n* 🔄 **Smart Recurrence**: Repeat events daily, weekly, monthly, or yearly (perfect for weekly show releases!).\r\n* 🔔 **Stay Notified**: Receive automatic alerts via Nextcloud Activity and System Notifications when a timer expires.\r\n* 🖼️ **Dual Layout**: Switch between **Stacked** (compact) and **Grid** (side-by-side) views to fit your style.\r\n* 📱 **PWA Ready**: Install the app on your phone or desktop for a native-like, full-screen experience.\r\n* 💻 **OCC Integration**: Administrators can manage countdowns using the OCC command line interface.\r\n* ✏️ **Custom Completion**: Choose between default, random, or custom messages when a countdown finishes.\r\n* 🗞️ **News Center**: Stay updated with the latest features and changes directly inside the app.\r\n* 🎮 **Easter Eggs**: Discover secrets hidden inside the app inspired by pop culture!\r\n\r\n## 📸 Screenshots\r\n\r\n### Main Dashboard\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://apps.nextcloud.com/apps/countdown\"\u003e\r\n    \u003cimg src=\"screenshots/desktop_dashboard.png\" width=\"100%\" style=\"border-radius: 8px;\" alt=\"Countdown Dashboard view\" /\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n### Dashboard Widget\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://apps.nextcloud.com/apps/countdown\"\u003e\r\n    \u003cimg src=\"screenshots/desktop_widget.png\" width=\"100%\" style=\"border-radius: 8px;\" alt=\"Countdown Widget view\" /\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e  \r\n\r\n### Edit Panel\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://apps.nextcloud.com/apps/countdown\"\u003e\r\n    \u003cimg src=\"screenshots/desktop_edit.png\" width=\"100%\" style=\"border-radius: 8px;\" alt=\"Countdown Edit view\" /\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n### Mobile PWA View\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://apps.nextcloud.com/apps/countdown\"\u003e\r\n    \u003cimg src=\"screenshots/mobile_dashboard.png\" width=\"30%\" alt=\"Mobile Home\" /\u003e\r\n  \u003c/a\u003e\r\n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\r\n  \u003ca href=\"https://apps.nextcloud.com/apps/countdown\"\u003e\r\n    \u003cimg src=\"screenshots/mobile_widget.png\" width=\"30%\" alt=\"Mobile Widget\" /\u003e\r\n  \u003c/a\u003e\r\n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\r\n  \u003ca href=\"https://apps.nextcloud.com/apps/countdown\"\u003e\r\n    \u003cimg src=\"screenshots/mobile_edit.png\" width=\"30%\" alt=\"Mobile Edit\" /\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n## 🚀 Installation\r\n\r\n### Option 1: Nextcloud App Store (Recommended)\r\nYou can find **Countdown** directly in your Nextcloud instance:\r\n1. Log in to your Nextcloud as an **Administrator**.\r\n2. Click on your profile icon (top right) and select **Apps**.\r\n3. Use the search bar to look for **\"Countdown\"**.\r\n4. Click **Download and enable**.\r\n\r\n### Option 2: Manual Installation\r\nIf you prefer to install it manually or want to use a specific version:\r\n1. **Download**: Get the latest release from the [GitHub Releases](https://github.com/infinit7even/countdown/releases) page or the [Nextcloud App Store](https://apps.nextcloud.com/apps/countdown).\r\n2. **Extract**: Unpack the `countdown.tar.gz` (or clone the repo) into your Nextcloud's `apps/` directory.\r\n3. **Permissions**: Ensure the folder permissions are correct (usually `www-data` for Linux servers).\r\n   ```bash\r\n   chown -R www-data:www-data /path/to/nextcloud/apps/countdown\r\n   ```\r\n4. **Enable**: Go to the **Apps** section in your Nextcloud and click **Enable** on the Countdown app, or use the command line:\r\n   ```bash\r\n   sudo -u www-data php /path/to/nextcloud/occ app:enable countdown\r\n   ```\r\n\r\n## 🛠️ Creating your first Countdown\r\n1. **Name \u0026 Date**: Simply click the \"+\" button, enter a title (e.g., \"GTA VI Release\"), and pick the target date and time.\r\n2. **Add some Magic**: You can choose a custom **emoji** to represent your event and add a **description** for more details.\r\n3. **Go Recurrent**: Enable the **Repeat** toggle if you want the countdown to restart automatically (Daily, Weekly, Monthly, or Yearly).\r\n4. **The Celebration**: When the timer reaches zero, you'll receive a **Nextcloud Notification** and be greeted by a **burst of confetti**! 🎉\r\n\r\n## 🔔 How Notifications Work\r\n\r\nThe app ensures you never miss an event using two methods:\r\n\r\n*   **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! 🎉).\r\n*   **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). \r\n\r\n\u003e [!NOTE]\r\n\u003e 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**.\r\n\r\n#### 1. Nextcloud Background Jobs\r\nFirst, ensure your Nextcloud instance is set to **Cron** mode (Recommended) rather than AJAX:\r\n1. Go to **Settings** \u003e **Basic settings**.\r\n2. Under **Background jobs**, select **Cron**.\r\n\r\n#### 2. System Crontab\r\nThe 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.\r\n\r\n**To edit your crontab:**\r\n```bash\r\n# For standard installations (e.g., Ubuntu/Debian)\r\nsudo crontab -u www-data -e\r\n```\r\n\r\n**Add the appropriate line for your setup:**\r\n\r\n| Environment | Frequency | Command |\r\n| :--- | :--- | :--- |\r\n| **Standard / Bare Metal** | Every minute | `* * * * * php /path/to/nextcloud/occ countdown:check-timers` |\r\n| **Docker Container** | Every minute | `* * * * * docker exec --user www-data nextcloud php occ countdown:check-timers` |\r\n| **Nextcloud All-in-One** | Every minute | `* * * * * docker exec --user www-data nextcloud-aio-nextcloud php occ countdown:check-timers` |\r\n| **Snap** | Every minute | `* * * * * nextcloud.occ countdown:check-timers` |\r\n\r\n\u003e [!TIP]\r\n\u003e Use [crontab.guru](https://crontab.guru/) to experiment with different schedules or to understand the cron syntax better.\r\n\r\n## 💻  Administrative Commands (OCC)\r\n\r\nAdministrators can use the `occ` command line tool to manage countdowns and trigger notification checks manually from the terminal.\r\n\r\n| Command | Purpose |\r\n| :--- | :--- |\r\n| `countdown:check-timers` | Manually trigger an immediate notification check for all users. |\r\n| `countdown:list \u003cuser_id\u003e` | List all active countdowns for a specific user (including IDs). |\r\n| `countdown:add \u003cuser_id\u003e \u003cname\u003e \u003ctarget_date\u003e` | Add a new countdown programmatically. |\r\n| `countdown:delete \u003cuser_id\u003e \u003cid\u003e` | Delete a specific countdown using its numeric ID. |\r\n\r\n**Example: Adding a countdown via Docker**\r\n```bash\r\ndocker exec --user www-data nextcloud php occ countdown:add \"user_id\" \"Event Name\" \"2026-12-25 00:00:00\"\r\n```\r\n\r\n\u003e [!NOTE]\r\n\u003e 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.\r\n\r\n## 🪀Dashboard Widget\r\nTo see your countdowns at a glance:\r\n1. Go to your **Nextcloud Dashboard**.\r\n2. Scroll to the bottom and click **Edit widgets**.\r\n3. Enable the **Countdown** widget.\r\n\r\n## ❤️ Support the Project\r\n\r\nIf you find **Countdown** useful and want to support its development:\r\n*   **Star the Project**: Give us a star on [GitHub](https://github.com/infinit7even/countdown) to help others discover it.\r\n*   **Leave a Review**: Share your experience and feedback on the [Nextcloud App Store](https://apps.nextcloud.com/apps/countdown).\r\n*   **Support on Ko-fi**: Help me keep the project active and always updated to the latest Nextcloud versions by [buying me a coffee](https://ko-fi.com/infinit7even). ☕\r\n\r\nYour support helps me keep improving the app and adding new \"magic\" features! 🦊✨\r\n\r\n## 😊 Contributing \u0026 Feedback\r\n\r\n* **Bugs \u0026 Features**: Found a bug or have a great idea? Open an issue on [GitHub Issues](https://github.com/infinit7even/countdown/issues).\r\n* **Discussions**: Join the community for questions and tips on [GitHub Discussions](https://github.com/infinit7even/countdown/discussions).\r\n* **Source Code**: Explore the code or fork the project at [GitHub Repository](https://github.com/infinit7even/countdown).\r\n\r\n## ⚖️ License\r\nThis project is licensed under the **AGPL-3.0-or-later** license. See the [LICENSE](LICENSE) file for details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfinit7even%2Fcountdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finfinit7even%2Fcountdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfinit7even%2Fcountdown/lists"}