jalenng / twenty

Customizable timer that reminds you to take eye breaks

Twenty

Customizable timer that reminds you to take eye breaks

---

Overview

Twenty helps you prevent eye strain by reminding you to practice the 20-20-20 rule:

Every 20 minutes, look at something at least 20 feet away for 20 seconds.

---

🌟 Features

⛔ Blockers

Specify conditions for when you want to maintain focus

⏲ Interval customization

Find your balance between preventing eye strain and maintaining your focus

🔊 Sound customization

Personalize your experience with custom notification sounds

😊 Ease of use

Runs on startup and minimizes to system tray--just set and forget

🖱 Simple user interface

Elegant, streamlined, and easy to use

---

📷 Screenshot

---

💻 Download

Get the latest releases for Windows and macOS here.

Note: Twenty has not been code-signed or notarized. That means your operating system may try to warn you that the app is unsafe, depending on your security settings.

---

➕ Contributing

Issues

Found a bug🐞 or got a suggestion💡? Report them here.

Pull requests

Pull requests are welcome--please don't hesitate to open one!

---

👨‍💻 Development

Twenty is built with Node.js, Electron, React, and ❤.

Make sure you have Node.js and npm installed on your computer.

npm i

Installs the required dependencies.

npm run dev

Starts the React development environment and Electron process.

npm run build

Packages Twenty for production.

---

📃 License

MIT © Jalen Ng

twenty's Issues

'npm i' fails with conflicting peer dependencies

Hi!

I have been enjoying the app and liked its simplicity, however, I wanted to add some features I think would be useful:

1. Add an option to disable the full screen blend off
2. Add a "Remind me in 2 Minutes" Button to the notification
3. Make the time to focus on something far away adjustable

Sadly, when trying to initialize the React project using npm i it results in conflicting depndencies:

npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: [email protected]
npm error Found: [email protected]
npm error node_modules/react
npm error   react@"^17.0.2" from the root project
npm error   peer react@">=16.8.0 <18.0.0" from @fluentui/[email protected]
npm error   node_modules/@fluentui/foundation-legacy
npm error     @fluentui/foundation-legacy@"^8.2.13" from @fluentui/[email protected]
npm error     node_modules/@fluentui/react
npm error       @fluentui/react@"^8.87.1" from the root project
npm error   11 more (@fluentui/react, @fluentui/react-focus, ...)
npm error
npm error Could not resolve dependency:
npm error peer react@"^16.2.0" from [email protected]
npm error node_modules/react-circle
npm error   react-circle@"^1.1.1" from the root project
npm error
npm error Conflicting peer dependency: [email protected]
npm error node_modules/react
npm error   peer react@"^16.2.0" from [email protected]
npm error   node_modules/react-circle
npm error     react-circle@"^1.1.1" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.

Additionally, using --force a module seems to be missing:

npm error ModuleNotFoundError: No module named 'distutils'
npm error gyp ERR! configure error
npm error gyp ERR! stack Error: `gyp` failed with exit code: 1
npm error gyp ERR! stack     at ChildProcess.onCpExit (C:\GitLib\Github\twenty\node_modules\node-gyp\lib\configure.js:284:16)
npm error gyp ERR! stack     at ChildProcess.emit (node:events:514:28)
npm error gyp ERR! stack     at ChildProcess._handle.onexit (node:internal/child_process:294:12)
npm error gyp ERR! System Windows_NT 10.0.22631
npm error gyp ERR! command "C:\\Tools\\NodeJS\\node.exe" "C:\\GitLib\\Github\\twenty\\node_modules\\node-gyp\\bin\\node-gyp.js" "rebuild"    
npm error gyp ERR! cwd C:\GitLib\Github\twenty\node_modules\ffi-napi
npm error gyp ERR! node -v v20.10.0
npm error gyp ERR! node-gyp -v v9.1.0
npm error gyp ERR! not ok