whatisgithub

What is yoman?

hparadiz/yoman — explained in plain English

Analysis updated 2026-05-18

0QMLAudience · developerComplexity · 3/5Setup · moderate

In one sentence

Yoman is a read-only KDE Plasma 6 panel widget that shows a month calendar and upcoming events pulled from your existing Google Calendar or KOrganizer accounts.

Mindmap

mindmap
  root((yoman))
    What it does
      Panel calendar widget
      Month grid popup
      Event notifications
      Read only design
    Tech stack
      QML
      Qt 6
      KDE Frameworks
      Plasma
    Use cases
      View upcoming events
      Meeting alerts
      Google Calendar sync
      KOrganizer sync
    Audience
      KDE Plasma users
      Linux desktop users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

See upcoming calendar events and a month grid directly from the KDE Plasma desktop panel.

USE CASE 2

Get desktop notifications or a full-screen alert before a meeting starts.

USE CASE 3

View existing Google Calendar or KOrganizer-synced events without managing a separate calendar app.

USE CASE 4

Join or open meeting links directly from the event details popup.

What is it built with?

QMLQt 6KDE FrameworksPlasma

How does it compare?

hparadiz/yomantaqsblaze/notcheddylanrothhuck/quickshell
Stars001
LanguageQMLQMLQML
Setup difficultymoderateeasyhard
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a KDE Plasma 6 desktop with Qt 6 and KDE Frameworks 6 installed.

The README does not state a license for this repository.

So what is it?

Yoman is a calendar widget for the panel bar of KDE Plasma 6, a desktop environment used on many Linux computers. Its name comes from the Hebrew word for diary or agenda. It sits in your desktop panel showing the current date, and when clicked, opens a popup showing a month grid along with the day's scheduled events. The widget pulls in events from calendars you already have set up elsewhere, rather than managing its own separate calendar system. It supports Google Calendar, connected through KDE's built-in Online Accounts feature, as well as any calendar that KOrganizer, KDE's calendar and personal information tool, already syncs, such as local files or CalDAV servers. Importantly, Yoman is read-only by design: it never creates, edits, or deletes any event. All those changes still happen in the original calendar app, and Yoman simply reflects the latest version the next time it refreshes. Beyond just showing dates, the widget offers a scrollable event list with details like time, location, description, and attendee responses, plus quick Join or Open buttons for meeting links. It can send desktop notifications a set amount of time before an event starts, and optionally show a full-screen alert while a meeting is actively happening. Users can also toggle which individual calendars are visible through a right-click menu, and a settings window covers appearance, calendar sources, and keyboard shortcuts. Because it relies entirely on KDE's own Google account integration rather than running its own separate login process, the README includes detailed guidance for people in workplaces with restricted Google Workspace accounts, explaining how to narrow down the permissions requested so an organization's IT policies are more likely to approve the connection. Installing Yoman requires a KDE Plasma 6 system with Qt 6, and comes with an install script that builds the small helper programs it needs and adds it to the desktop's widget picker.

Copy-paste prompts

Prompt 1
Walk me through installing Yoman on my KDE Plasma 6 desktop using the install-plasmoid.sh script.
Prompt 2
How do I connect my Google Calendar to Yoman through KDE's Online Accounts settings?
Prompt 3
Explain how to narrow Google OAuth scopes for Yoman if my work Google Workspace blocks third-party app access.
Prompt 4
What is the difference between how Yoman handles Google Calendar versus KOrganizer as a calendar source?

Frequently asked questions

What is yoman?

Yoman is a read-only KDE Plasma 6 panel widget that shows a month calendar and upcoming events pulled from your existing Google Calendar or KOrganizer accounts.

What language is yoman written in?

Mainly QML. The stack also includes QML, Qt 6, KDE Frameworks.

What license does yoman use?

The README does not state a license for this repository.

How hard is yoman to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is yoman for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.