OfflineIMAP - 版の履歴

Sanlun: 誤字の訂正

2025-06-05T06:52:25Z

誤字の訂正

← 古い版		2025年6月5日 (木) 15:52時点における版
149行目:		149行目:
	=== mutt 用に自動的にメールボックスを作成 ===		=== mutt 用に自動的にメールボックスを作成 ===

	[Mutt]]は単にIMAP や Maildir のディレクトリを指し示したり、どのサブディレクトリがメールボックスであるかを推測することはできませんが、 offlineimap は同期するメールボックスを含む muttrc フラグメントを生成することができます。		[[Mutt]]は単にIMAP や Maildir のディレクトリを指し示したり、どのサブディレクトリがメールボックスであるかを推測することはできませんが、 offlineimap は同期するメールボックスを含む muttrc フラグメントを生成することができます。

	{{hc\|~/.offlineimaprc\|<nowiki>		{{hc\|~/.offlineimaprc\|<nowiki>

Sanlun: python2で書かれていたコードを3に更新

2025-06-04T01:43:27Z

python2で書かれていたコードを3に更新

← 古い版		2025年6月4日 (水) 10:43時点における版
251行目:		251行目:
	GNU Privacy Guard を使うことで暗号化ファイルにパスワードを保存することができます。このセクションの設定を行う前にまず [[GnuPG]] をセットアップしてください。[[GnuPG#gpg-agent\|パスワードを入力しなくても]] GPG の秘密鍵をいつでも使えるようにしておく必要があります。		GNU Privacy Guard を使うことで暗号化ファイルにパスワードを保存することができます。このセクションの設定を行う前にまず [[GnuPG]] をセットアップしてください。[[GnuPG#gpg-agent\|パスワードを入力しなくても]] GPG の秘密鍵をいつでも使えるようにしておく必要があります。

	まずプレーンテキストファイルにメールアカウントのパスワードを入力してください。暗号化されていないパスワードがディスクに書き込まれないように、ファイルの作成は [[tmpfs]] 上の {{ic\|700}} パーミッションの安全なディレクトリで行なって下さい。それから、~~公開鍵~~でファイルを暗号化します:		まずプレーンテキストファイルにメールアカウントのパスワードを入力してください。暗号化されていないパスワードがディスクに書き込まれないように、ファイルの作成は [[tmpfs]] 上の {{ic\|700}} パーミッションの安全なディレクトリで行って下さい。それから、GnuPGで自身を受信者にしてファイルを[[GnuPG#暗号化と復号化\|暗号化]]します:

	$ gpg --default-recipient-self -e ''/path/to/plain/password''

	必要なくなったプレーンテキストファイルは削除してください。暗号化したファイルは最終的に必要な場所 (例: {{ic\|~/.offlineimappass.gpg}}) に移動してください。		必要なくなったプレーンテキストファイルは削除してください。暗号化したファイルは最終的に必要な場所 (例: {{ic\|~/.offlineimappass.gpg}}) に移動してください。
260行目:		258行目:

	{{hc\|~/.offlineimap.py\|2=		{{hc\|~/.offlineimap.py\|2=
	#! /usr/bin/env ~~python2~~		#! /usr/bin/env python
	from subprocess import check_output		from subprocess import check_output

	def get_pass():		def get_pass():
	return check_output("gpg -dq ~/.offlineimappass.gpg", shell=True).~~strip~~("\n")		return check_output("gpg -dq ~/.offlineimappass.gpg", shell=True).rstrip(b"\n")
	}}		}}

292行目:		290行目:

	{{hc\|~/.offlineimap.py\|2=		{{hc\|~/.offlineimap.py\|2=
	#! /usr/bin/env ~~python2~~		#! /usr/bin/env python
	from subprocess import check_output		from subprocess import check_output

Sanlun: 英語版の最新版の内容に更新

2025-06-03T11:12:21Z

英語版の最新版の内容に更新

差分を表示

Kusanaginoturugi: add Category.

2024-05-01T12:07:49Z

add Category.

← 古い版		2024年5月1日 (水) 21:07時点における版
1行目:		1行目:
	[[Category:メール取得エージェント]]		[[Category:メール取得エージェント]]
			[[Category:OpenPGP]]
	[[en:OfflineIMAP]]		[[en:OfflineIMAP]]
	{{Related articles start}}		{{Related articles start}}

Kusakata.bot: Pkg/AUR テンプレートの更新

2019-07-04T12:41:29Z

Pkg/AUR テンプレートの更新

← 古い版		2019年7月4日 (木) 21:41時点における版
286行目:		286行目:
	===== 方法 1: gnomekeyring の Python モジュールを使う =====		===== 方法 1: gnomekeyring の Python モジュールを使う =====

	{{~~pkg~~\|python2-gnomekeyring}} をインストールしてください。		{{AUR\|python2-gnomekeyring}} をインストールしてください。

	{{hc\|~/.offlineimap.py\|<nowiki>		{{hc\|~/.offlineimap.py\|<nowiki>

Kusakata: カテゴリ変更

2019-02-28T15:10:12Z

カテゴリ変更

← 古い版		2019年3月1日 (金) 00:10時点における版
1行目:		1行目:
	[[Category:メール~~クライア~~ント]]		[[Category:メール取得エージェント]]
	[[en:OfflineIMAP]]		[[en:OfflineIMAP]]
	{{Related articles start}}		{{Related articles start}}

Kusakata.bot: 文字列「Tips and tricks」を「ヒントとテクニック」に置換

2017-10-12T14:15:52Z

文字列「Tips and tricks」を「ヒントとテクニック」に置換

← 古い版		2017年10月12日 (木) 23:15時点における版
74行目:		74行目:
	メールアカウントが同期されます。何か問題が発生した場合、エラーメッセージをよく見て下さい。OfflineIMAP は基本的に問題について詳しい出力を表示します。最終的な製品からのトレースバックを取得するのに開発者が悩む必要がないようにするためです。		メールアカウントが同期されます。何か問題が発生した場合、エラーメッセージをよく見て下さい。OfflineIMAP は基本的に問題について詳しい出力を表示します。最終的な製品からのトレースバックを取得するのに開発者が悩む必要がないようにするためです。

			== ヒントとテクニック ==
	== Tips and tricks ==

	=== バックグラウンドで offlineimap を実行 ===		=== バックグラウンドで offlineimap を実行 ===

Kusakata: 同期

2016-10-25T12:11:18Z

同期

← 古い版		2016年10月25日 (火) 21:11時点における版
2行目:		2行目:
	[[en:OfflineIMAP]]		[[en:OfflineIMAP]]
	{{Related articles start}}		{{Related articles start}}
	{{~~Related4~~\|isync}}		{{Related\|isync}}
	{{Related\|notmuch}}		{{Related\|notmuch}}
	{{Related\|msmtp}}		{{Related\|msmtp}}
91行目:		91行目:
	[Account main]		[Account main]
	# Minutes between syncs		# Minutes between syncs
	autorefresh = 5		autorefresh = 0.5
	# ~~Number of quick-syncs between autorefreshes.~~ Quick-syncs do not update if the		# Quick-syncs do not update if the only changes were to IMAP flags.
			# autorefresh=0.5 together with quick=10 yields
	# only changes were to IMAP flags
			# 10 quick refreshes between each full refresh, with 0.5 minutes between every
			# refresh, regardless of type.
	quick = 10		quick = 10

248行目:		250行目:

	def get_pass(account):		def get_pass(account):
	return check_output("pass Mail/" + account, shell=True).~~rstrip~~()		return check_output("pass Mail/" + account, shell=True).splitlines()[0]
	}}		}}

283行目:		285行目:

	===== 方法 1: gnomekeyring の Python モジュールを使う =====		===== 方法 1: gnomekeyring の Python モジュールを使う =====

			{{pkg\|python2-gnomekeyring}} をインストールしてください。

	{{hc\|~/.offlineimap.py\|<nowiki>		{{hc\|~/.offlineimap.py\|<nowiki>
324行目:		328行目:
	</nowiki>}}		</nowiki>}}

			証明書を設定するために、シェルから上記のスクリプトを実行してください。
	To set the credentials, run this script from a shell.

	===== 方法 2: {{AUR\|gnome-keyring-query}} ツールを使う =====		===== 方法 2: {{AUR\|gnome-keyring-query}} ツールを使う =====
367行目:		371行目:
	==== Emacs EasyPG ====		==== Emacs EasyPG ====

	~~See~~ http://www.emacswiki.org/emacs/OfflineIMAP#toc2		http://www.emacswiki.org/emacs/OfflineIMAP#toc2 を見てください。

	==== KeePass / KeePassX ====		==== KeePass / KeePassX ====

	~~Install~~ {{AUR\|python2-keepass-git}} ~~from the AUR, then add the following to your~~ offlineimap.py ~~file~~:		AUR から {{AUR\|python2-keepass-git}} をインストールして、{{ic\|offlineimap.py}} ファイルに以下を追加してください:

	{{bc\|<nowiki>		{{bc\|<nowiki>
461行目:		465行目:
	* or add {{ic\|sslcacertfile}} with the path to the system CA certificates file. Needs {{Pkg\|ca-certificates}} installed. This validates the remote ssl certificate chain against the Certification Authorities in that file.		* or add {{ic\|sslcacertfile}} with the path to the system CA certificates file. Needs {{Pkg\|ca-certificates}} installed. This validates the remote ssl certificate chain against the Certification Authorities in that file.
	sslcacertfile = /etc/ssl/certs/ca-certificates.crt		sslcacertfile = /etc/ssl/certs/ca-certificates.crt

			=== Copying message, connection closed ===

			ERROR: Copying message -2 [acc: email] connection closed
			Folder sent [acc: email]: ERROR: while syncing sent [account email] connection closed

			上記の問題はローカルとサーバーで同じメッセージが作成されていることが原因です。メールのプロバイダが自動的にローカルクライアントと同じフォルダに送信したメールを保存した場合に発生します。この問題が起こったときはローカルクライアントで送信済みメッセージの保存を無効化してください。

	== 参照 ==		== 参照 ==

	* [http://lists.alioth.debian.org/mailman/listinfo/offlineimap-project OfflineIMAP 公式メーリングリスト]		* [http://lists.alioth.debian.org/mailman/listinfo/offlineimap-project OfflineIMAP 公式メーリングリスト]
	* [http://roland.entierement.nu/blog/2010/09/08/gnus-dovecot-offlineimap-search-a-howto.html Gnus, Dovecot, OfflineIMAP, search: a HOWTO]
	* [http://pbrisbin.com/posts/mutt_gmail_offlineimap/ Mutt + Gmail + Offlineimap] - An outline of brisbin's simple gmail/mutt setup using cron to keep offlineimap syncing.		* [http://pbrisbin.com/posts/mutt_gmail_offlineimap/ Mutt + Gmail + Offlineimap] - An outline of brisbin's simple gmail/mutt setup using cron to keep offlineimap syncing.

Kusakata: ページの作成:「Category:メールクライアント en:OfflineIMAP {{Related articles start}} {{Related4|isync}} {{Related|notmuch}} {{Related|msmtp}} {{Related articles end}}...」

2015-12-18T12:47:09Z

ページの作成:「Category:メールクライアント en:OfflineIMAP {{Related articles start}} {{Related4|isync}} {{Related|notmuch}} {{Related|msmtp}} {{Related articles end}}...」

新規ページ

[[Category:メールクライアント]]
[[en:OfflineIMAP]]
{{Related articles start}}
{{Related4|isync}}
{{Related|notmuch}}
{{Related|msmtp}}
{{Related articles end}}

[http://offlineimap.org/ OfflineIMAP] は IMAP サーバーからメールを同期する Python ユーティリティです。POP3 プロトコルや mbox は使えないため、通常 [[Mutt]] などの MUA と組み合わされて使われます。

== インストール ==

{{pkg|offlineimap}} をインストールしてください。開発版は {{AUR|offlineimap-git}} をインストールしてください。

== 設定 ==

Offlineimap には2つのデフォルト設定ファイルが付属しており、どちらも {{ic|/usr/share/offlineimap/}} にあります。{{ic|offlineimap.conf}} には全ての設定が含まれておりコメントが付与されています。また、{{ic|offlineimap.conf.minimal}} にはコメントが付いておらず多少の設定しか含まれていません (参照: [[#Minimal|Minimal]])。

デフォルト設定ファイルのどちらかを {{ic|~/.offlineimaprc}} にコピーしてください。

{{note|Writing a comment after an option/value on the same line is invalid syntax, hence take care that comments are placed on their own separate line.}}

=== Minimal ===

{{ic|offlineimap.conf.minimal}} のコメントが付いたバージョンは以下になります:

{{hc|~/.offlineimaprc|<nowiki>
[general]
# List of accounts to be synced, separated by a comma.
accounts = main

[Account main]
# Identifier for the local repository; e.g. the maildir to be synced via IMAP.
localrepository = main-local
# Identifier for the remote repository; i.e. the actual IMAP, usually non-local.
remoterepository = main-remote
# Status cache. Default is plain, which eventually becomes huge and slow.
status_backend = sqlite

[Repository main-local]
# Currently, offlineimap only supports maildir and IMAP for local repositories.
type = Maildir
# Where should the mail be placed?
localfolders = ~/Maildir

[Repository main-remote]
# Remote repos can be IMAP or Gmail, the latter being a preconfigured IMAP.
type = IMAP
remotehost = host.domain.tld
remoteuser = username
</nowiki>}}

=== フォルダの同期の選択 ===

特定のフォルダだけを同期したい場合、{{ic|~/.offlineimaprc}} でアカウントの '''remote''' セクションに [http://offlineimap.org/doc/nametrans.html#folderfilter folderfilter] を使います。例えば、以下の設定では {{ic|Inbox}} と {{ic|Sent}} フォルダだけが同期されます:

{{hc|~/.offlineimaprc|2=
[Repository main-remote]
# Synchronize only the folders Inbox and Sent:
folderfilter = lambda foldername: foldername in ["Inbox", "Sent"]
...
}}

他のオプションについては、[http://offlineimap.org/doc/nametrans.html#folderfilter 公式ドキュメント] を見て下さい。

== 使用方法 ==

offlineimap を実行する前に、ローカルリポジトリとして使用するペアレントディレクトリを作成してください:
$ mkdir ~/Maildir

そして、プログラムを実行してください:
$ offlineimap

メールアカウントが同期されます。何か問題が発生した場合、エラーメッセージをよく見て下さい。OfflineIMAP は基本的に問題について詳しい出力を表示します。最終的な製品からのトレースバックを取得するのに開発者が悩む必要がないようにするためです。

== Tips and tricks ==

=== バックグラウンドで offlineimap を実行 ===

大抵のメール転送エージェントはデフォルトで、プログラムを定期的に同期させることで[[デーモン]]としてツールを使うのが前提になっています。offlineimap では、バックグラウンドで作業を制御する設定はあまりありません。

紛らわしいことに、バックグラウンドの設定は設定ファイルのあらゆるところに散らばっています:

{{hc|~/.offlineimaprc|<nowiki>
# In the general section
[general]
# Controls how many accounts may be synced simultaneously
maxsyncaccounts = 1

# In the account identifier
[Account main]
# Minutes between syncs
autorefresh = 5
# Number of quick-syncs between autorefreshes. Quick-syncs do not update if the
# only changes were to IMAP flags
quick = 10

# In the remote repository identifier
[Repository main-remote]
# Instead of closing the connection once a sync is complete, offlineimap will
# send empty data to the server to hold the connection open. A value of 60
# attempts to hold the connection for a minute between syncs (both quick and
# autorefresh).This setting has no effect if autorefresh and holdconnectionopen
# are not both set.
keepalive = 60
# OfflineIMAP normally closes IMAP server connections between refreshes if
# the global option autorefresh is specified. If you wish it to keep the
# connection open, set this to true. This setting has no effect if autorefresh
# is not set.
holdconnectionopen = yes
</nowiki>}}

==== systemd サービス ====

バックグラウンドジョブを実行するように設定したら、以下の systemd サービスで offlineimap を管理することができます:

{{hc|/etc/systemd/system/offlineimap@.service|<nowiki>
[Unit]
Description=Start offlineimap as a daemon
Requires=network-online.target
After=network.target

[Service]
User=%i
ExecStart=/usr/bin/offlineimap
KillSignal=SIGUSR2
Restart=always

[Install]
WantedBy=multi-user.target
</nowiki>}}

サービスを作成したら {{ic|offlineimap@''user''.service}} を[[有効化]]してください。

{{Note|[[D-Bus]] の操作を含む設定をした場合 (例: [[#Gnome Keyring]])、上記の systemd サービスは直接使うのではなく [[systemd/ユーザー]] に書かれているように systemd のユーザーインスタンスとして使う必要があります。{{ic|DBUS_SESSION_BUS_ADDRESS}} 変数を適切に設定してください。}}

=== mutt 用に自動的にメールボックスを作成 ===

[[Mutt]] cannot be simply pointed to an IMAP or maildir directory and be expected to guess which subdirectories happen to be the mailboxes, yet offlineimap can generate a muttrc fragment containing the mailboxes that it syncs.

{{hc|~/.offlineimaprc|<nowiki>
[mbnames]
enabled = yes
filename = ~/.mutt/mailboxes
header = "mailboxes "
peritem = "+%(accountname)s/%(foldername)s"
sep = " "
footer = "\n"
</nowiki>}}

Then add the following lines to {{ic|~/.mutt/muttrc}}.

{{hc|~/.mutt/muttrc|<nowiki>
# IMAP: offlineimap
set folder = "~/Mail"
source ~/.mutt/mailboxes
set spoolfile = "+account/INBOX"
set record = "+account/Sent\ Items"
set postponed = "+account/Drafts"
</nowiki>}}

{{ic|account}} is the name you have given to your IMAP account in {{ic|~/.offlineimaprc}}.

=== Gmail の設定 ===

This remote repository is configured specifically for Gmail support, substituting folder names in uppercase for lowercase, among other small additions. Keep in mind that this configuration does not sync the ''All Mail'' folder, since it is usually unnecessary and skipping it prevents bandwidth costs:

{{hc|~/.offlineimaprc|<nowiki>
[Repository gmail-remote]
type = Gmail
remoteuser = user@gmail.com
remotepass = password
nametrans = lambda foldername: re.sub ('^\[gmail\]', 'bak',
re.sub ('sent_mail', 'sent',
re.sub ('starred', 'flagged',
re.sub (' ', '_', foldername.lower()))))
folderfilter = lambda foldername: foldername not in ['[Gmail]/All Mail']
# Necessary as of OfflineIMAP 6.5.4
sslcacertfile = /etc/ssl/certs/ca-certificates.crt
</nowiki>}}

{{Note|
* If you have Gmail set to another language, the folder names may appear translated too, e.g. "verzonden_berichten" instead of "sent_mail".
* After version 6.3.5, offlineimap also creates remote folders to match your local ones. Thus you may need a nametrans rule for your local repository too that reverses the effects of this nametrans rule. If you don't want to make a reverse nametrans rule, you can disable remote folder creation by putting this in your remote configuration: {{ic|<nowiki>createfolders = False</nowiki>}}
* 2012年10月1日現在、gmail の SSL 証明書のフィンガープリントはいつも同じだとは限りません。このため {{ic|cert_fingerprint}} を使うよりも {{ic|sslcacertfile}} を使って SSL の確認をするほうが良いでしょう ([[#SSL フィンガープリントが一致しない]]を参照)。
}}

=== パスワードの管理 ===

==== .netrc ====

以下の行を {{ic|~/.netrc}} に追加してください:

machine hostname.tld
login [your username]
password [your password]

Do not forget to give the file appropriate rights like 600 or 700:
$ chmod 600 ~/.netrc

==== GPG を使う ====

GNU Privacy Guard を使うことで暗号化ファイルにパスワードを保存することができます。このセクションの設定を行う前にまず [[GnuPG]] をセットアップしてください。[[GnuPG#gpg-agent|パスワードを入力しなくても]] GPG の秘密鍵をいつでも使えるようにしておく必要があります。

まずプレーンテキストファイルにメールアカウントのパスワードを入力してください。暗号化されていないパスワードがディスクに書き込まれないように、ファイルの作成は [[tmpfs]] 上の {{ic|700}} パーミッションの安全なディレクトリで行なって下さい。それから、公開鍵でファイルを暗号化します:

$ gpg --default-recipient-self -e ''/path/to/plain/password''

必要なくなったプレーンテキストファイルは削除してください。暗号化したファイルは最終的に必要な場所 (例: {{ic|~/.offlineimappass.gpg}}) に移動してください。

次にパスワードを復号化する python 関数を作成します:

{{hc|~/.offlineimap.py|2=
#! /usr/bin/env python2
from subprocess import check_output

def get_pass():
return check_output("gpg -dq ~/.offlineimappass.gpg", shell=True).strip("\n")
}}

上記のファイルを {{ic|~/.offlineimaprc}} からロードして、定義した関数を指定してください:

{{hc|~/.offlineimaprc|2=
[general]
# Path to file with arbitrary Python code to be loaded
pythonfile = ~/.offlineimap.py
...

[Repository ''example'']
# Decrypt and read the encrypted password
remotepasseval = get_pass()
...
}}

==== pass を使う ====

[[pass]] は GPG ベースのシンプルなコマンドラインのパスワードマネージャです。

最初にメールアカウントのパスワードを作成:

$ pass insert Mail/''account''

次にパスワードを復号化する python 関数を作成:

{{hc|~/.offlineimap.py|2=
#! /usr/bin/env python2
from subprocess import check_output

def get_pass(account):
return check_output("pass Mail/" + account, shell=True).rstrip()
}}

上記はマルチアカウントセットアップの例です。前述の ''pass'' の引数はカスタマイズできます。

{{ic|~/.offlineimaprc}} からファイルをロードして、定義した関数を指定:

{{hc|~/.offlineimaprc|2=
[general]
# Path to file with arbitrary Python code to be loaded
pythonfile = ~/.offlineimap.py
...

[Repository Gmail]
# Decrypt and read the encrypted password
remotepasseval = get_pass("Gmail")
...
}}

==== Gnome Keyring ====

In configuration for remote repositories the remoteusereval/remotepasseval fields can be set to custom python code that evaluates to the username/password. The code can be a call to a function defined in a Python script pointed to by 'pythonfile' config field. Create {{ic|~/.offlineimap.py}} according to either of the two options below and use it in the configuration:

{{bc|<nowiki>
[general]
pythonfile = ~/.offlineimap.py

[Repository examplerepo]
type = IMAP
remotehost = mail.example.com
remoteusereval = get_username("examplerepo")
remotepasseval = get_password("examplerepo")
</nowiki>}}

===== 方法 1: gnomekeyring の Python モジュールを使う =====

{{hc|~/.offlineimap.py|<nowiki>
#! /usr/bin/env python2

import gnomekeyring as gkey

def set_credentials(repo, user, pw):
KEYRING_NAME = "offlineimap"
attrs = { "repo": repo, "user": user }
keyring = gkey.get_default_keyring_sync()
gkey.item_create_sync(keyring, gkey.ITEM_NETWORK_PASSWORD,
KEYRING_NAME, attrs, pw, True)

def get_credentials(repo):
keyring = gkey.get_default_keyring_sync()
attrs = {"repo": repo}
items = gkey.find_items_sync(gkey.ITEM_NETWORK_PASSWORD, attrs)
return (items[0].attributes["user"], items[0].secret)

def get_username(repo):
return get_credentials(repo)[0]
def get_password(repo):
return get_credentials(repo)[1]

if __name__ == "__main__":
import sys
import os
import getpass
if len(sys.argv) != 3:
print "Usage: %s <repository> <username>" \
% (os.path.basename(sys.argv[0]))
sys.exit(0)
repo, username = sys.argv[1:]
password = getpass.getpass("Enter password for user '%s': " % username)
password_confirmation = getpass.getpass("Confirm password: ")
if password != password_confirmation:
print "Error: password confirmation does not match"
sys.exit(1)
set_credentials(repo, username, password)
</nowiki>}}

To set the credentials, run this script from a shell.

===== 方法 2: {{AUR|gnome-keyring-query}} ツールを使う =====

{{hc|~/.offlineimap.py|<nowiki>
#! /usr/bin/env python2
# executes gnome-keyring-query get passwd
# and returns the output

import locale
from subprocess import Popen, PIPE

encoding = locale.getdefaultlocale()[1]

def get_password(p):
(out, err) = Popen(["gnome-keyring-query", "get", p], stdout=PIPE).communicate()
return out.decode(encoding).strip()
</nowiki>}}

==== python2-keyring ====

There is a general solution that should work for any keyring. Install [http://pypi.python.org/pypi/keyring python2-keyring] from [[AUR]], then change your ~/.offlineimaprc to say something like:

{{bc|<nowiki>
[general]
pythonfile = /home/user/offlineimap.py
...
[Repository RemoteEmail]
remoteuser = username@host.net
remotepasseval = keyring.get_password("offlineimap","username@host.net")
...
</nowiki>}}

and somewhere in ~/offlineimap.py add {{ic|import keyring}}. Now all you have to do is set your password, like so:

{{bc|$ python2
>>> import keyring
>>> keyring.set_password("offlineimap","username@host.net", "MYPASSWORD")}}

and it will grab the password from your (kwallet/gnome-) keyring instead of having to keep it in plaintext or enter it each time.

==== Emacs EasyPG ====

See http://www.emacswiki.org/emacs/OfflineIMAP#toc2

==== KeePass / KeePassX ====

Install {{AUR|python2-keepass-git}} from the AUR, then add the following to your offlineimap.py file:

{{bc|<nowiki>
#! /usr/bin/env python2
import os, getpass
from keepass import kpdb

def get_keepass_pw(dbpath, title="", username=""):
if os.path.isfile(dbpath):
db = kpdb.Database(dbpath, getpass.getpass("Master password for '" + dbpath + "': "))
for entry in db.entries:
if (entry.title == title) and (entry.username == username):
return entry.password
else:
print "Error: '" + dbpath + "' does not exist."
return

</nowiki>}}
(Credit to aki--aki: https://gist.github.com/aki--aki/5180359)

Next, edit your ~/.offlineimaprc:

{{bc|<nowiki>
[general]
# VVV Set this path correctly VVV
pythonfile = /home/user/offlineimap.py
...
[Repository RemoteEmail]
remoteuser = username@host.net
# Set the DB path as well as the title and username of the specific entry you'd like to use.
# This will prompt you on STDIN at runtime for the kdb master password.
remotepasseval = get_keepass_pw("/path/to/database.kdb", title="<entry title>", username="<entry username>")
...
</nowiki>}}

Note that as-is, this does not support KDBs with keyfiles, only KDBs with password-only auth.

=== Kerberos 認証 ===

Install {{AUR|python2-kerberos}} from [[AUR]] and do not specify remotepass in your .offlineimaprc.
OfflineImap figure out the reset all if have a valid Kerberos TGT.
If you have 'maxconnections', it will fail for some connection. Comment 'maxconnections' out will solve this problem.

== トラブルシューティング ==

=== UI の上書きと自動更新の設定 ===

For the sake of troubleshooting, it is sometimes convenient to launch offlineimap with a more verbose UI, no background syncs and perhaps even a debug level:
$ offlineimap [ -o ] [ -d <debug_type> ] [ -u <ui> ]
;-o
:Disable autorefresh, keepalive, etc.

;-d <debug_type>
:Where ''<debug_type>'' is one of {{Ic|imap}}, {{Ic|maildir}} or {{Ic|thread}}. Debugging imap and maildir are, by far, the most useful.

;-u <ui>
:Where ''<ui>'' is one of {{Ic|CURSES.BLINKENLIGHTS}}, {{Ic|TTY.TTYUI}}, {{Ic|NONINTERACTIVE.BASIC}}, {{Ic|NONINTERACTIVE.QUIET}} or {{Ic|MACHINE.MACHINEUI}}. TTY.TTYUI is sufficient for debugging purposes.

{{Note|More recent versions use the following for <ui>: {{Ic|blinkenlights}}, {{Ic|ttyui}}, {{Ic|basic}}, {{Ic|quiet}} or {{Ic|machineui}}.}}

=== フォルダが作成できない ===

In version 6.5.3, offlineimap gained the ability to create folders in the remote repository, as described [http://comments.gmane.org/gmane.mail.imap.offlineimap.general/4784 here].

This can lead to errors of the following form when using {{Ic|nametrans}} on the remote repository:
ERROR: Creating folder bar on repository foo-remote
Folder 'bar'[foo-remote] could not be created. Server responded: ('NO', ['[ALREADYEXISTS] Duplicate folder name bar (Failure)'])

The solution is to provide an inverse {{Ic|nametrans}} lambda for the local repository, e.g.

{{hc|~/.offlineimaprc|<nowiki>
[Repository foo-local]
nametrans = lambda foldername: foldername.replace('bar', 'BAR')

[Repository foo-remote]
nametrans = lambda foldername: foldername.replace('BAR', 'bar')
</nowiki>}}

* For working out the correct inverse mapping. the output of {{Ic|offlineimap --info}} should help.
* After updating the mapping, it may be necessary to remove all of the folders under {{Ic|$HOME/.offlineimap/}} for the affected accounts.

=== SSL フィンガープリントが一致しない ===

ERROR: Server SSL fingerprint 'keykeykey' for hostname 'example.com' does not match configured fingerprint. Please verify and set 'cert_fingerprint' accordingly if not set yet.

To solve this, add to {{ic|~/.offlineimaprc}} (in the same section as {{ic|1=ssl = yes}}) one of the following:
* either add {{ic|cert_fingerprint}}, with the certificate fingerprint of the remote server. This checks whether the remote server certificate matches the given fingerprint.
cert_fingerprint = keykeykey
* or add {{ic|sslcacertfile}} with the path to the system CA certificates file. Needs {{Pkg|ca-certificates}} installed. This validates the remote ssl certificate chain against the Certification Authorities in that file.
sslcacertfile = /etc/ssl/certs/ca-certificates.crt

== 参照 ==

* [http://lists.alioth.debian.org/mailman/listinfo/offlineimap-project OfflineIMAP 公式メーリングリスト]
* [http://roland.entierement.nu/blog/2010/09/08/gnus-dovecot-offlineimap-search-a-howto.html Gnus, Dovecot, OfflineIMAP, search: a HOWTO]
* [http://pbrisbin.com/posts/mutt_gmail_offlineimap/ Mutt + Gmail + Offlineimap] - An outline of brisbin's simple gmail/mutt setup using cron to keep offlineimap syncing.