https://github.com/wojciechpolak/yact
YACT (Yet Another Countdown Timer) - a customizable countdown timer web application in React/Next.js
https://github.com/wojciechpolak/yact
countdown-timer docker nextjs pwa react redux-toolkit self-hosted tailwindcss timer
Last synced: 2 months ago
JSON representation
YACT (Yet Another Countdown Timer) - a customizable countdown timer web application in React/Next.js
- Host: GitHub
- URL: https://github.com/wojciechpolak/yact
- Owner: wojciechpolak
- License: gpl-3.0
- Created: 2024-09-30T19:31:59.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2026-03-28T16:14:12.000Z (3 months ago)
- Last Synced: 2026-03-28T18:25:33.783Z (3 months ago)
- Topics: countdown-timer, docker, nextjs, pwa, react, redux-toolkit, self-hosted, tailwindcss, timer
- Language: TypeScript
- Homepage:
- Size: 1.49 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# YACT (Yet Another Countdown Timer)
YACT is a customizable countdown timer web application. It allows
users to set timers with specific hours, minutes, and seconds, and
offers various settings to tailor the timer's behavior according to
individual preferences.
YACT has been inspired by Big Timer (an online service), but has been
developed as a free software, self-hosted alternative, built from
scratch with Next.js, React, and Tailwind CSS.
## Features
- Customizable Timer: Set hours, minutes, and seconds to create a
timer that fits your needs.
- Two Modes: Choose between a fixed duration countdown or a target
time mode that counts down to a specific clock time (e.g., 16:00:00).
- Repeat Functionality: Option to automatically repeat the timer when
it reaches zero.
- Count Up After Timer Ends: Choose to have the timer count upwards
after reaching zero.
- Sound Notifications:
- Play a sound when the timer ends.
- Play a ticking sound during each of the last 10 seconds.
- Responsive Design: Optimized for various screen sizes, including
mobile devices.
- Fullscreen Mode: Toggle fullscreen view for an immersive experience.
- URL Parameters: Share or bookmark specific timer settings using URL
parameters.
- Settings Persistence: User preferences are saved locally to maintain
settings across sessions.
## Running
### Running with Docker (out of the box)
```shell
docker run -it -p 8080:8080 --name yact ghcr.io/wojciechpolak/yact
```
### Running with Docker Compose
```shell
curl https://raw.githubusercontent.com/wojciechpolak/yact/master/docker-compose.yml | docker compose -f - up
```
### Running from the source code
1. Clone the Repository
```shell
git clone https://github.com/wojciechpolak/yact.git
cd yact
```
2. Install Dependencies
```shell
npm ci
```
3. Run the Application
```shell
npm run dev
```
4. Open in Browser
Visit http://localhost:3000 to access the countdown timer.
### Testing
```shell
npm test
npm run e2e
npm run e2e:vrt:docker
```
Creating baseline images:
```shell
npm run e2e:vrt:baseline:docker
```
## License
This project is licensed under the GNU General Public License v3.0.
See the [COPYING](COPYING) file for details.
### Icon Attribution
The icons used in this project are from the [OpenMoji](https://openmoji.org)
project and are licensed under the
[CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) license.
### Audio Attribution
- Big Bell by Slothfully_So -- https://freesound.org/s/685065/ -- License: Creative Commons 0
- Clock Bonmark Tick by zmastafa102 -- https://freesound.org/s/509714/ -- License: Creative Commons 0