korgalore: small taskbar app ui

korgalore: small taskbar app ui

[Konstantin Ryabitsev]

Hi:

With the help of opus[*], I added a small taskbar miniapp to run background
korgalore syncs. It needs a lot of testing, so if you're a korgalore user,
please try it out. It should, in theory, work in most desktop environments but
I only tested it under gnome.

Here's what it can do:

  - System tray indicator with status icons (idle/syncing/error)
  - Automatic background sync at configurable intervals (default: 5 minutes)
  - Manual "Sync Now" option from the menu
  - Gmail re-authentication via browser when tokens expire (no terminal needed)
  - Edit configuration file directly from the menu with automatic TOML validation

It's not yet released, so you'll need to get korgalore master and run from
checkout.

You can run the taskbar app from terminal as `kgl gui`, or you can install the
.desktop file in ~/.local/share/applications/ and run it straight from the app
menu.

The goal is not to make this an entirely GUI app -- initial setup is still
done in the terminal. However, the idea is that once you have `kgl pull`
running smoothly, you can then move the regular sync runs into the taskbar
app and receive notifications in your desktop environment when something goes
wrong.

Please try it out.

-K

[*] yes, I know, but this feature would have never existed without opus,
    because I can't be arsed to write GUIs most of the time.

Re: korgalore: small taskbar app ui

[Bugspray Bot]

Hello:

This conversation is now tracked by Kernel.org Bugzilla:
https://bugzilla.kernel.org/show_bug.cgi?id=220974

There is no need to do anything else, just keep talking.
-- 
Deet-doot-dot, I am a bot.
Kernel.org Bugzilla (bugspray 0.1-dev)

Re: korgalore: small taskbar app ui

[Konstantin Ryabitsev]

On Tue, Jan 13, 2026 at 04:50:19PM +0000, Bugspray Bot wrote:
> Hello:
> 
> This conversation is now tracked by Kernel.org Bugzilla:
> https://bugzilla.kernel.org/show_bug.cgi?id=220974

(Clearly, bugspray bot is on the fritz. I turned it off for the moment until I
figure out what's going on with it -- I'm having a small bot rebellion on my
hands in the past few days.)

-K

Re: korgalore: small taskbar app ui

[Ard Biesheuvel]

On Tue, 13 Jan 2026 at 17:51, Konstantin Ryabitsev
<konstantin@linuxfoundation.org> wrote:
>
> Hi:
>
> With the help of opus[*], I added a small taskbar miniapp to run background
> korgalore syncs. It needs a lot of testing, so if you're a korgalore user,
> please try it out. It should, in theory, work in most desktop environments but
> I only tested it under gnome.
>
> Here's what it can do:
>
>   - System tray indicator with status icons (idle/syncing/error)
>   - Automatic background sync at configurable intervals (default: 5 minutes)
>   - Manual "Sync Now" option from the menu
>   - Gmail re-authentication via browser when tokens expire (no terminal needed)
>   - Edit configuration file directly from the menu with automatic TOML validation
>
> It's not yet released, so you'll need to get korgalore master and run from
> checkout.
>
> You can run the taskbar app from terminal as `kgl gui`, or you can install the
> .desktop file in ~/.local/share/applications/ and run it straight from the app
> menu.
>
> The goal is not to make this an entirely GUI app -- initial setup is still
> done in the terminal. However, the idea is that once you have `kgl pull`
> running smoothly, you can then move the regular sync runs into the taskbar
> app and receive notifications in your desktop environment when something goes
> wrong.
>
> Please try it out.
>

Another awesome feature, thanks a lot for this!

Some notes from a user:

- AppIndicator3 is called AyatanaAppIndicator3 on my (debian testing
based) system
- when using pipx to install korgalore, the optional GUI dependencies
need to be installed in the virtual environment too, e.g., I needed to
so something like

~/.local/share/pipx/venvs/korgalore/bin/python3 -m pip install PyGObject

to get the introspection working, even though python3-gi was already
available system-wide.

Re: korgalore: small taskbar app ui

[Konstantin Ryabitsev]

On Fri, Jan 16, 2026 at 09:53:15AM +0100, Ard Biesheuvel wrote:
> > The goal is not to make this an entirely GUI app -- initial setup is still
> > done in the terminal. However, the idea is that once you have `kgl pull`
> > running smoothly, you can then move the regular sync runs into the taskbar
> > app and receive notifications in your desktop environment when something goes
> > wrong.
> >
> > Please try it out.
> >
> 
> Another awesome feature, thanks a lot for this!
> 
> Some notes from a user:
> 
> - AppIndicator3 is called AyatanaAppIndicator3 on my (debian testing
> based) system
> - when using pipx to install korgalore, the optional GUI dependencies
> need to be installed in the virtual environment too, e.g., I needed to
> so something like

Thanks for the feedback! I know very little about writing gui apps, so I
expect there will be tons of special cases required for all the gnome versions
out there.

From what I read, the recommendation is not to install gtk/gnome dependencies
into the pipx environment, because they are likely to conflict with the system
libraries and cause more problems that way. I'll double-check if this is still
correct today.

Thanks!
-K

Re: korgalore: small taskbar app ui

[Sudeep Holla]

On Tue, Jan 13, 2026 at 11:50:58AM -0500, Konstantin Ryabitsev wrote:
> Hi:
> 
> With the help of opus[*], I added a small taskbar miniapp to run background
> korgalore syncs. It needs a lot of testing, so if you're a korgalore user,
> please try it out. It should, in theory, work in most desktop environments but
> I only tested it under gnome.
> 
> Here's what it can do:
> 
>   - System tray indicator with status icons (idle/syncing/error)
>   - Automatic background sync at configurable intervals (default: 5 minutes)
>   - Manual "Sync Now" option from the menu
>   - Gmail re-authentication via browser when tokens expire (no terminal needed)
>   - Edit configuration file directly from the menu with automatic TOML validation
> 
> It's not yet released, so you'll need to get korgalore master and run from
> checkout.
> 
> You can run the taskbar app from terminal as `kgl gui`, or you can install the

I tried it from the terminal and it has be running fine updating my inbox
regularly in the background for more than 1 day now.

> .desktop file in ~/.local/share/applications/ and run it straight from the app
> menu.
> 

I haven't tried this part and I am not sure if I will use that, so sorry
can't test that part.

-- 
Regards,
Sudeep