Skip to content
greeenosPublic

About

Open-source, self-hosted task app and Things 3 alternative in one 45 MB Docker image. Projects, recurring tasks, shared lists, attachments and an installable PWA. Try the live browser demo.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zings

Zings

Your tasks. Your server.
An open-source, self-hosted Things 3 alternative. Runs in the browser and installs as an app on desktop and phone.

Latest release MIT license GitHub Actions Docker image

Watch the film · Try the demo · Install · User guide · Support Zings

Zings Today view, with tasks grouped by project

Capture ideas in your Inbox, make a plan for Today and leave the rest for later. Zings brings a familiar task-planning rhythm to your own server, with shared projects, attachments and a browser app you can install on your devices.

It runs as one Docker container with PocketBase and SQLite: a 45 MB image that idles at about 30 MB of RAM, with a ~170 KB (gzipped) web app. No Node.js process at runtime. No telemetry in the app, and your workspace stays on the backend you choose.

Watch Zings in action

zings-showreel.mp4

Task planning, shared projects and the mobile app in 30 seconds. Watch on the website · Download the film · English subtitles

Try the demo

Try Zings in your browser without creating an account. Your demo changes stay in your browser.

Open the demo

What you can do

Plan your work Keep the useful details
Inbox, Today, Upcoming, Anytime, Someday and Logbook Notes, checklists, tags and file attachments
Areas, projects, headings and shared projects Separate scheduling dates and deadlines
Recurring tasks, including every third Tuesday Priorities and projects that reveal one next step at a time
English and Czech natural-language task entry Task timers, focus history and activity charts
Calendar view and external ICS subscriptions Private ICS export of planned work and tracked sessions
Keyboard navigation, multi-select and drag ordering Optional client-side encryption for task notes
Things 3 import and full JSON export Light, dark and auto themes

Install Zings as a PWA on your phone or desktop. Previously loaded lists work offline, and task changes queue until the backend is reachable again. Reminders use browser notifications and Web Push on supported devices; HTTPS and permission are required.

For integrations, use the REST API, webhooks and email-to-task endpoint. AI breakdown and capture work with your own Anthropic or OpenRouter key. Setup and examples.

Calendar status: Zings can subscribe to external ICS feeds and publish its own. It doesn't yet write edits back into Google, Apple or Outlook calendars.

A closer look

Inside a task
Notes, checklist, dates and task priority
The week ahead
Zings calendar and daily agenda
After dark
Zings dark theme
Focus over time
Activity chart and focus history
Phone views, upcoming tasks and the design system

Zings on a phone in light mode Zings on a phone in dark mode

Upcoming tasks Zings design system

Install

Install Docker, then run:

docker run -d --name zings --restart unless-stopped \
  -p 8090:8090 -v zings:/pb/pb_data -e TZ=Europe/Prague \
  ghcr.io/greeenos/zings:latest

Open http://localhost:8090 and create an account. The zings volume holds the database and files. A self-hosted instance supports up to five accounts, each with its own workspace; projects can be shared between them.

Prefer Compose?

curl -fsSL https://raw.githubusercontent.com/greeenos/zings/main/docker-compose.yml -o docker-compose.yml
docker compose up -d

Use HTTPS for PWA installation, encryption and push reminders. For private access, follow the Tailscale guide.

Updates and backups

Pull the new image, recreate the container with the same volume, and keep an independent backup of that volume. PocketBase also creates daily backups at 03:00 in the configured timezone and keeps the latest seven.

docker pull ghcr.io/greeenos/zings:latest
docker stop zings
docker rm zings
# Run the installation command again, keeping -v zings:/pb/pb_data.

Admin setup, SMTP, imports, offline behaviour and backup recovery.

Build it yourself

Requires Node.js 20+ and the PocketBase binary.

npm ci
npm run build
pocketbase serve
# App and backend: http://localhost:8090

For UI development, keep PocketBase running and use npm run dev. Run npm test, npm run lint and npx tsc --noEmit -p tsconfig.app.json before submitting code.

The app uses Preact, TypeScript, Vite, Tailwind and PocketBase. CONTRIBUTING.md covers contributions; SECURITY.md covers vulnerability reports.

Support Zings

Donations help cover development and server costs. You can also support the project by reporting bugs, contributing code or sharing it with someone who needs it.

Donate via Revolut or card

Ethereum Solana
Ethereum mainnet Solana mainnet
Ethereum donation address QR code Solana donation address QR code
0x72160619F847068AB307447d363D580d85A47002 DjnRV3h6VkvGCHiYSaqU2VKR66NCva46UYdQSfZtP4sd

Use the matching network and check the address in your wallet before sending. These are voluntary donations, not payments for an app subscription.

Feedback and sharing

Report a bug or suggest a feature. Focused pull requests are welcome.

Changelog

Zings is an independent project inspired by Things 3. It isn't affiliated with Cultured Code or Apple.

License and credits

The code is MIT licensed. UI icons use Iconoir (MIT). Empty-state artwork uses the Solar icon set by 480 Design, under CC BY 4.0.

Showreel music: “Inspired” by Kevin MacLeod (incompetech.com), track source, licensed under Creative Commons Attribution 4.0.

About

Open-source, self-hosted task app and Things 3 alternative in one 45 MB Docker image. Projects, recurring tasks, shared lists, attachments and an installable PWA. Try the live browser demo.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages