Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/filipchalupa/just-countdown
Countdown timer with remote control
https://github.com/filipchalupa/just-countdown
countdown remote-control webapp
Last synced: about 2 months ago
JSON representation
Countdown timer with remote control
- Host: GitHub
- URL: https://github.com/filipchalupa/just-countdown
- Owner: FilipChalupa
- Created: 2020-06-20T08:50:37.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-11-15T23:43:53.000Z (3 months ago)
- Last Synced: 2024-11-16T00:21:25.707Z (3 months ago)
- Topics: countdown, remote-control, webapp
- Language: TypeScript
- Homepage: https://just-countdown.eu
- Size: 2.03 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Just Countdown
Countdown timer with remote control.
- Web: [just-countdown.eu](https://just-countdown.eu/)
- Google Play Store: [Just Countdown](https://play.google.com/store/apps/details?id=eu.just_countdown.twa)
- Microsoft Store: [Just Countdown](https://apps.microsoft.com/store/detail/just-countdown/9P65S6HKWB6P)
[demo](https://user-images.githubusercontent.com/1045362/165823939-cb697d8d-8de0-4861-b781-af73e5551996.mp4)
## API
```
GET https://just-countdown.eu/api/control?id=my-countdown
```
Replace `my-countdown` with your own countdown ID.
Response is described by `type Data` in [pages/api/control.ts](pages/api/control.ts).
### Optional parameters
Add any of them to the URL above.
- `start` (start countdown)
- `pause` (pause countdown)
- `togglePaused` (toggle paused state)
- `showHours` (show hours)
- `hideHours` (hide hours)
- `toggleHours` (toggle hours visibility)
- `set=60` (set countdown to 60 seconds)
- `adjust=10` (add 10 more seconds to countdown)
#### Example
1. ```
GET https://just-countdown.eu/api/control?id=my-countdown&set=300&hideHours&start
```
Sets countdown to 5 minutes, hides hours and starts countdown.
1. ```
GET https://just-countdown.eu/api/control?id=my-countdown&adjust=-30
```
Subtracts 30 seconds from countdown.
#### Note
- Server may be off by few seconds.
## Development
```bash
npm ci
npm run dev
```