Re: korgalore v0.4 now available

[Mauro Carvalho Chehab <mchehab+huawei@kernel.org>]

Hi Konstantin,

On Tue, 20 Jan 2026 10:29:28 -0500
Konstantin Ryabitsev <konstantin@linuxfoundation.org> wrote:

> Hi, all:
> 
> Korgalore v0.4 is now available with IMAP OAuth2 support for Microsoft 365 and
> several GUI improvements.

I started trying it this week to have a copy of my public e-mails
on a separate machine at my office, and indeed it is an interesting
tool. I tested only maildir, as having accounts on oauth2 providers
for kernel stuff is always a lot more complex than it should be.

I used there both lei and non-lei feeds.

One thing that I missed is that "kgl pull" doesn't really pull
e-mails inside the mailbox, even when used with lei to pick the last
week/month of stuff: it just sets it to pick newest e-mails from
now on.

IMO, the default should be to populate maildir with the contents
from the lore git trees, when "kgl pull" is called, as, if one
wants to pick stuff there is because they usually want to look
at the most recent messages - eventually replying to them.
As such, IMHO, the mailbox to be sync altogether with the
already-existing messages from the specified period.

On the exceptional case where one doesn't want that, you could
provide a "--only-new" argument to pull - to skip the mailbox
filling with existing e-mails.

Just my 2 cents.

Regards,
Mauro



> 
> New features
> ------------
> 
> IMAP OAuth2 Authentication for Microsoft 365:
> 
> This release adds support for OAuth2 authentication (XOAUTH2) with Microsoft
> 365 accounts. The app includes a built-in Azure AD application ID for
> zero-configuration setup, though it is going to show up as "unverified"
> (it's too much work!).
> 
> Your corporate IT may block third-party or unverified apps by default, so in
> this case you will need to either get them to approve the korgalore app or
> give you their own client_id. 
> 
> Example configuration:
> 
>     [targets.office365]
>     type = 'imap'
>     auth_type = 'oauth2'
>     server = 'outlook.office365.com'
>     username = 'user@company.com'
> 
> Improvements
> ------------
> - Close network connections after sync runs to avoid keeping idle connections
>   open between periodic syncs (IMAP, HTTP sessions)
> - JMAP target now uses shared requests session for consistent User-Agent
>   header and proper connection cleanup
> - Add GUI optional dependencies to pyproject.toml (pip install korgalore[gui])
> - Support AyatanaAppIndicator3 as fallback for AppIndicator3 (needed on
>   Debian and derivatives)
> - GUI now monitors network availability via Gio.NetworkMonitor and skips
>   sync attempts when network is unavailable (airplane mode, resume from
>   suspend, etc.). Sync is automatically scheduled when network is restored.
> - GUI error messages now display actual error text instead of unhelpful
>   "see logs" messages, since logs are not collected by default
> 
> Full changelog and documentation:
> 
>     https://korgalore.docs.kernel.org/
> 
> Source repository:
> 
>     https://git.kernel.org/pub/scm/utils/korgalore/korgalore.git
> 
> Install via pipx:
> 
>     pipx install korgalore
> 
> -K
> 



Thanks,
Mauro