Skip to content
Go to file

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 -o ./tl \ && \
    chmod 755 ./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).

----- 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.




No packages published
You can’t perform that action at this time.