Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
████████╗██╗███╗   ███╗███████╗██╗     ██╗███╗   ██╗███████╗
╚══██╔══╝██║████╗ ████║██╔════╝██║     ██║████╗  ██║██╔════╝
   ██║   ██║██╔████╔██║█████╗  ██║     ██║██╔██╗ ██║█████╗
   ██║   ██║██║╚██╔╝██║██╔══╝  ██║     ██║██║╚██╗██║██╔══╝
   ██║   ██║██║ ╚═╝ ██║███████╗███████╗██║██║ ╚████║███████╗
   ╚═╝   ╚═╝╚═╝     ╚═╝╚══════╝╚══════╝╚═╝╚═╝  ╚═══╝╚══════╝

Timeline is a plain-text based distributed social network build on top of
git configuration manager. Timeline is:

- Distributed / Descentralized
- Secure / Solid / Spam aware
- GPL3 licensed
- Fun!

----- Installation ------------------------------------------------------------

Just curl for it:

  curl -sSLo ./tl \ && \
    chmod 755 ./tl

And don't forget to verify it:

  curl -sSLo - \ | \
    gpg --verify - tl

----- Getting started ---------------------------------------------------------

  # create new account (i.e. git repo) and sync with remote one.
  ./tl account create name ssh://user@host/therepo.git http://myrepopublicurl
  #                   ^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^
  #                   name url to push                 url to public pull

  # add some people to follow
  ./tl follow myfriend
  #           ^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^
  #           url to pull from            optional alias for this repo

  # done! check your timeline
  ./tl timeline refresh

  # Or if you are lazy, you can use alias
  ./tl tr

  # And you can filter your results by tags
  ./tl tr tag:Timeline

----- Use common tags ---------------------------------------------------------

Though you can tag any post/reply/tag with any tag that you want, there are
some common used tags with special meanings that you may want to known.
Please note that this is a convention, but there are no technical meaning of
use that.

spam: means that the tagged object is SPAM, and should be ignored
news: means that the tagged object is a breaking news and probable should be

timeline: means that this is a timeline related news or fact, usually is
          used by timeline developers to notify changes.

A General rule: use lowercase and the largest tag, for example tag
"politics" is preferred instead of "Politics" or "POL". Please note that
tags are social, which means that everyone can see what tags you publish,
adn how are you tagging other contents. If you mark a spam with "news" tag,
does not means anything, because your tag "news" can be tagged as "spam"

----- Using scores ------------------------------------------------------------

Since version 1.1 you can use scores to filter even more your timeline.
Scores are a numerical value for a post. When someone score a post give to
the post one point, or even substract one point. Only one scored is taken in
consideration for each user, so if the same user add two scores, only one is

Score is presented in the timeline and you can use "score-min:<value>" or
"score-max:<value>" as filter to filter your timeline using scores. Also,
setting configuration variable timeline.filter-show and timeline.filter-hide
you can use scores to filter timeline by default.

----- Understanding timeline --------------------------------------------------

Timeline works linking different user's accounts, which are actually git
repositories. The people you follows are submodules of your account
repository, so it's easy to update and parse using a common format for

To discover new people just use the `network refresh` command, which follows
your followings in order to discover all people connected with you.

Followings only works in one way, that means that even if you publish some
content, only people who follows you can read that messages in their

You can create your repository public or private, if it's private, then
security is delegated to the git client (usually uses HTTPS or SSH).

----- Public directories ------------------------------------------------------

Since version 1.8 timeline support public directory listings. A public
directory is an URL which points to a plain text file with the form:

<name> <url> <tags...>

And allows to discover new timeline accounts around the globe. Please keep in
mind that directories are designed to discover new accounts that can be
interesting for you (usually you want to discover by tags), but the aim of
the timeline is still to follow only trusted people.

You can create your own directory, just server a file like that, and add to
timeline via command: `tl dir add dirname dirurl`. Timeline has a
default directory which points to If you wish to
inscribe your timeline account to this directory just send a mail to
timeline-dir (at)

----- Some advantages ---------------------------------------------------------

1. Is a decentralized network. No one controls the network, and no one can
   close it.
2. Each follower has a reduced copy of your repo, so even if you repository
   is deleted, each follower of you can upload a copy of your repository,
   keeping your message online.
3. There are no tracks, no one spy you if you don't want to.
4. You can manage multiple copies of your repo, so if for some reason one is
   deleted, you can still using others.
5. There are no spam, because only people who follows can publish to you
   (i.e. you only see messages from people who follows).
6. There are no indiscriminated following. Well, there could be, but makes
   no sense, because you do not realized that who is following you, so
   following you to achive more followers for a third account doesn't work

------ Get involved -----------------------------------------------------------

This is a basic implementation of timeline protocol, but any other
implementation is welcome too. If you found a bug or want any enhancement,
please open a issue.

Happy hacking!


Timeline is a plain-text based distributed social network build on top of git configuration manager.



Security policy