Repolode
schej-it

schej-it/timeful

Free group availability poll that finds the best meeting time across calendars and time zones, a self-hostable alternative to Doodle.

Open-source alternative to:Doodle

Stars
1,807
Forks
157
Open issues
63
Last commit
5 days ago

What is it?

Timeful is a scheduling tool for finding a time that works for a group. Organizers create a poll with a date and time range, participants mark when they are available, and the site shows where everyone's availability overlaps. Responses can be marked as available or as "if needed", and a subset of participants can be checked to see when they are free.

The project integrates with Google Calendar, Outlook and Apple calendar so that availability can be pulled from real calendars rather than entered by hand. It supports scheduling across different time zones, email notifications and reminders, and availability groups that track members' calendars over time. Polls can be duplicated, results can be exported as CSV, and responses can be restricted so only the creator sees them.

The codebase uses Vue 2 for the frontend, Go for the backend, MongoDB for storage and TailwindCSS for styling. A plugin API lets developers read and set availability on Timeful events from browser extensions, and the repository includes deployment guides for Docker Compose and NixOS.

Key features

  • 01Shows where all participants' availability overlaps
  • 02Supports marking times as available or as "if needed"
  • 03Connects to Google Calendar, Outlook and Apple calendar
  • 04Handles scheduling across different time zones
  • 05Sends email notifications and reminders
  • 06Exports availability results as CSV

Use cases

  • Picking a meeting time for a team spread across time zones
  • Organizing a group dinner or event where people have different schedules
  • Running a self-hosted scheduling poll instead of a third-party service
  • Building browser extensions that read or set availability through the plugin API

Quick start

  1. 1

    Read the Deployment Guide for self-hosting with Docker Compose or NixOS

Things to know

  • Self-hosting requires setting up MongoDB and a Go backend, which takes some effort.
  • Licensed under AGPL-3.0, which requires source disclosure for modified network-deployed versions.

In collections

Topics

FAQ

What is timeful?
Free group availability poll that finds the best meeting time across calendars and time zones, a self-hostable alternative to Doodle. Timeful is a scheduling tool for finding a time that works for a group. Organizers create a poll with a date and time range, participants mark when they are available, and the site shows where everyone's availability overlaps. Responses can be marked as available or as "if needed", and a subset of participants can be checked to see when they are free.
Is timeful free to use? What license does it have?
timeful is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is timeful still maintained?
Actively maintained. The last commit to timeful was on Nov 3, 2026.
What can I use timeful for?
Picking a meeting time for a team spread across time zones Organizing a group dinner or event where people have different schedules Running a self-hosted scheduling poll instead of a third-party service Building browser extensions that read or set availability through the plugin API
How do I install timeful?
Read the Deployment Guide for self-hosting with Docker Compose or NixOS
Where can I get timeful?
The source code and installation instructions are on GitHub: https://github.com/schej-it/timeful

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects