Skip to main content

a mail retrieval, sorting, and delivering system

Project description

Description

getmail6 is a flexible, extensible mail retrieval system with support for POP3, IMAP4, SSL variants of both, maildirs, mboxrd files, external MDAs, arbitrary message filtering, single-user and domain-mailboxes, and many other useful features.

Licence

getmail is Copyright (C) 1998-2025 Charles Cazabon and others. getmail is licensed for use under the GNU General Public License version 2 (only). See docs/COPYING for specific terms and distribution information.

getmail-gmail-xoauth-tokens is Copyright 2012 Google Inc. getmail-gmail-xoauth-tokens is licensed for under the Apache License, Version 2.0

Bugs

getmail6 has adaptations to work with Python 3. These changes might still contain some bugs. Please report them at https://github.com/getmail6/getmail6. See docs/BUGS for instructions on reporting bugs.

Installation

To install:

pip install getmail6

To uninstall:

pip uninstall getmail6

You can install getmail6 in your home directory if you add --user.

If getmail6 is available via your Linux distribution, you better use that.

Usage

getmail6 is not a python API. getmail6 provides command line tools:

  • getmail

  • getmail_maildir

  • getmail_mbox

  • getmail_fetch

  • getmail-gmail-xoauth-tokens

Configuration

Before using getmail you must configure it. See docs/configuration.txt and docs/getmailrc-examples. An example:

[retriever]
type = SimpleIMAPSSLRetriever
server = imap.gmail.com
port = 993
username = <your_email_here>
#password = ... or
password_command = ("pass", "<your_email_here>")

[destination]
type = Maildir
path = ~/Mail/<your_email_here>/INBOX/

[options]
read_all = true
delete = true

Gmail

For gmail, after having enabled 2-Step Authentication, let google generate an “app password” for you. Then, for the above example, use pass edit <your_email_here> and change to the generate one.

  • Go to https://mail.google.com

  • If you are signed in, on the left upper corner there is a cogwheel symbol for settings

  • Choose “See all Settings”

  • “Accounts and Imports” tab, then “Other Google Account Settings”/”Security” brings you to https://myaccount.google.com/u/0/security?hl=en

  • Turn on “2-Step Verification” (also known as 2-factor-authentication or 2FA)

  • In “App passwords”, generate a password for your device

  • Update this in your password command.

See also: https://support.google.com/accounts/answer/185833

getmail is a native app. See https://developers.google.com/identity/protocols/oauth2/native-app Still, to download your email from gmail to your computer using OAuth2 you need to grant getmail OAuth2 access to the scope https://mail.google.com/, as you would to web apps. Unfortunately, the init step in example 12 in docs/getmailrc-examples has to be repeated regularly. This makes the app password method above a better alternative. Don’t forget to remove the use_xoauth2 line, if you switch from Oauth2 to app password.

Tests

There is now a test folder that uses docker-mailserver for black box testing.

Tests are work in progress.

Documentation

See the HTML documentation for details on setting up and using getmail.

docs/documentation.html
docs/configuration.html
docs/faq.html
docs/troubleshooting.html

It is included in the docs subdirectory, and will be installed in <PREFIX>/doc/getmail-<version>/ (by default).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

getmail-6.19.8.tar.gz (210.1 kB view details)

Uploaded Source

Built Distribution

getmail-6.19.8-py3-none-any.whl (230.8 kB view details)

Uploaded Python 3

File details

Details for the file getmail-6.19.8.tar.gz.

File metadata

  • Download URL: getmail-6.19.8.tar.gz
  • Upload date:
  • Size: 210.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for getmail-6.19.8.tar.gz
Algorithm Hash digest
SHA256 1dccecb44a76d585ff2176f805a47a702cdd192e4cb6c0ce5d93c31059e4d7de
MD5 3483f35af8331f2c3c408f42420219c1
BLAKE2b-256 f0785f9e38eae5d7ccdeb3cc15a000e06cc4ce71c78ca5b9f1902372be60d133

See more details on using hashes here.

Provenance

The following attestation bundles were made for getmail-6.19.8.tar.gz:

Publisher: publish.yml on getmail6/getmail6

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file getmail-6.19.8-py3-none-any.whl.

File metadata

  • Download URL: getmail-6.19.8-py3-none-any.whl
  • Upload date:
  • Size: 230.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for getmail-6.19.8-py3-none-any.whl
Algorithm Hash digest
SHA256 89f1730bf16964f26ddb3989a7f8a77ff091c3a3c7df5df131c4fad0aa85645e
MD5 1455073caa91df790669e3bed7c72f60
BLAKE2b-256 29557c4bd0cf9e46807960cec7af3a968b3bf30ad34daaf9fb98b88ec357efe5

See more details on using hashes here.

Provenance

The following attestation bundles were made for getmail-6.19.8-py3-none-any.whl:

Publisher: publish.yml on getmail6/getmail6

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page