ssoma.git about / heads / tags
some sort of mail archiver (legacy)
$ git log --pretty=format:'%h %s (%cs)%d'
2e9aef3 README: add warnings about the lack of v2 support (2018-12-28)
(HEAD -> master)
f598840 extractor: warn about v2 repositories (2018-12-28)
29b74d2 Makefile.PL: do not depend on git (2018-06-13)
0da642c hold lock while extracting (2017-11-29)
9d25eaf extractor: do not needlessly update config file (2017-03-21)
3dbda32 extractor: backup state file when updating and fsync (2017-03-21)
4a53e8e txt2pre: remove CGI.pm dependency (2016-10-26)
2ec0ca2 doc: do not override Makefile if POD2* is set (2016-05-30)
a060c49 remove Email::Address dependency (2016-05-25)
d9bc690 doc: ssoma_repository: clarify we use the first Message-ID (2016-04-21)
...
$ git cat-file blob HEAD:README
ssoma - some sort of mail archiver
----------------------------------
WARNING: ssoma will not be updated for public-inbox v2 repositories.
Nowadays, public-inbox has NNTP support which makes ssoma redundant.
ssoma is a git-based mail archiver and transport. Email is injected via
ssoma-mda(1) (MDA: mail delivery agent) on a server and may be shared
(via git) and extracted to mbox, Maildir, or IMAP via ssoma(1). ssoma
existed primarily as the mechanism (not policy) for public-inbox v1.
Features
--------
* stores email in git, so readers have a full history of the mailing list
* mail user-agent (MUA) users may choose from IMAP, mbox(5), and Maildir
* uses only well-documented and easy-to-implement data formats
Install
-------
Installation should be easy and require only a few, commonly-available
packages. See http://ssoma.public-inbox.org/INSTALL for details.
Hacking
-------
Source code is available via git:
git clone git://80x24.org/ssoma
See below for contact info.
Contact
-------
We are happy to see feedback of all types via plain-text email.
Please email comments, user/developer discussion, patches, bug reports,
and pull requests to the public-inbox discussion list at:
meta@public-inbox.org
Please Cc: all recipients when replying (this is not a requirement of
public-inbox or ssoma, but a good idea since we do not require
subscription). This also makes it easier to rope in folks of
tangentially related projects we depend on (e.g. git developers on
git@vger.kernel.org).
You can subscribe via ssoma, LISTNAME is a name of your choosing:
URL=git://public-inbox.org/meta
LISTNAME=public-inbox
# to initialize a maildir (this may be a new or existing maildir,
# ssoma will not touch existing messages)
# If you prefer mbox, use mbox:/path/to/mbox as the last argument
ssoma add $LISTNAME $URL maildir:/path/to/maildir
# read with your favorite MUA (only using mutt as an example)
mutt -f /path/to/maildir # (or /path/to/mbox)
# to keep your mbox or maildir up-to-date, periodically run the following:
ssoma sync $LISTNAME
# your MUA may modify and delete messages from the maildir or mbox,
# this does not affect ssoma functionality at all
# to sync all your ssoma subscriptions
ssoma sync
# You may wish to sync in your cronjob
ssoma sync --cron
Mail repository format
----------------------
If you are uncomfortable running code in ssoma for any reason and
would rather read directly from the git repository, the following
document describes it:
http://ssoma.public-inbox.org/ssoma_repository.txt
Again, note that this DOES NOT cover the public-inbox v2 repository
format.
Copyright
---------
Copyright 2013-2016 all contributors <meta@public-inbox.org>
License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
Additional permission under GNU GPL version 3 section 7:
If you modify this program, or any covered work, by linking or
combining it with the OpenSSL project's OpenSSL library (or a
modified version of that library), containing parts covered by the
terms of the OpenSSL or SSLeay licenses, the copyright holder(s)
grants you additional permission to convey the resulting work.
Corresponding Source for a non-source form of such a combination
shall include the source code for the parts of OpenSSL used as well
as that of the covered work.
# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master README: add warnings about the lack of v2 support (2018-12-28)
# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
--format='%(refname:short) %(subject) (%(creatordate:short))'
v0.2.0 ssoma 0.2.0 - a bunch of updates (2016-03-03) tar.gz
v0.1.0 ssoma 0.1.0 (2014-05-05) tar.gz
v0.0.0 ssoma 0.0.0 - initial release (2014-04-21) tar.gz
git clone https://80x24.org/ssoma.git