GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Korgalore
  • Installation
  • Gmail Quickstart
  • Configuration
  • Usage
  • Digests
  • Contributing
  • View page source

This view

  • Original page
  • New address

GeezerVison is showing korgalore.docs.kernel.org — Korgalore — Korgalore documentation

Korgalore

Korgalore is a tool for feeding public-inbox git repositories directly into mail targets (Gmail, JMAP, IMAP, or local maildir) as an alternative to subscribing. It provides a workaround for Gmail’s notorious hostility to high-volume technical mailing list traffic.

Warning

This is beta-quality software. It can explode or cause you to miss mail.

Overview

Gmail is notoriously hostile to high-volume technical mailing list traffic. It will routinely throttle incoming messages, mark them as spam, or just drop them outright based on some unknown internal heuristic. Gmail’s throttling is responsible for hundreds of thousands of messages sitting in the kernel.org mail queue just waiting to be delivered.

Korgalore can feed public-inbox archives and lei search results directly into your mail system of choice, bypassing most of Gmail’s hostile anti-features when used with Gmail targets.

About the Name

It’s a play on “k.org lore” and “Orgalorg,” who is a primordial cosmic entity in the Adventure Time universe – the “breaker of worlds,” which is basically what Gmail is to mailing lists.

Features

  • Direct integration with public-inbox repositories

  • Support for lore.kernel.org archives

  • Support for lei searches

  • Multiple delivery targets:

    • Gmail (via REST API)

    • JMAP servers (e.g., Fastmail)

    • IMAP servers

    • Local maildir

    • Pipe commands

  • Daily or weekly digests, optionally with summaries written by a language model (experimental, see Digests)

  • GNOME taskbar application for background syncing

  • Bozofilter for blocking unwanted senders

Non-features

  • No filtering beyond bozofilter (use lei for that)

  • No querying (use lei for that)

Contents:

  • Installation
    • Prerequisites
    • Installing from PyPI
    • Installing from Source
    • Running from Git Checkout
    • GUI Installation
    • Development Installation
    • Shell Completion
    • Verifying Installation
  • Gmail Quickstart
    • Step 1: Install Korgalore
    • Step 2: Set Up Gmail API Credentials
    • Step 3: Create a Configuration File
    • Step 4: Authenticate with Gmail
    • Step 5: Pull Messages
    • Step 6: Check Your Gmail
    • One-Off Message Import (Yank)
    • Unsubscribing
    • Next Steps
    • Troubleshooting
  • Configuration
    • Configuration File Location
    • Modular Configuration (conf.d)
    • Gmail Setup
    • Maildir Setup
    • IMAP Setup
    • IMAP OAuth2 Setup (Microsoft 365)
    • Pipe Setup
    • Dummy Setup
    • Configuration File Format
    • Complete Example
    • GUI Configuration
    • Data Directory
    • Main Section
    • Logging
  • Usage
    • Command Line Interface
    • Commands
    • Common Usage Patterns
  • Digests
    • What a Digest Looks Like
    • Plain Digests
    • Summarized Digests
    • The Digest Worker
    • Privacy
    • Troubleshooting
  • Contributing
    • Getting Started
    • Code Style
    • Testing
    • Submitting Changes
    • Developer Certificate of Origin
    • Communication

Indices and tables

  • Index

  • Module Index

  • Search Page

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.