Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Shaarli2Twitter plugin

This plugin uses the Twitter API to automatically tweet public links published on Shaarli.

Everytime a new link is shaared, use the "Tweet" checkbox in the form to post it on Twitter. You can edit every tweet format manually if needed.

Note: private links and link edits can't be tweeted.


  • PHP 7.1+
  • PHP cURL extension
  • PHP mbstring extension
  • Shaarli >= v0.8.1 (checkout the release page for compatibility)


Download the latest release, and put the folder shaarli2twitter under your plugins/ directory.

Then you can enable the plugin in the plugin administration page http://shaarli.tld/?do=pluginadmin.

Note: the foldername must be shaarli2twitter to work.

Example in command lines:

wget <release URL>.tar.gz
tar xfz <archive>.tar.gz
mv <archive>/shaarli2twitter /path/to/shaarli/plugins


For this plugin to work, you need to register your Shaarli as a Twitter application in your account, and retrieve 4 keys used to authenticate API calls.

You must set this keys in the plugin administration page

Step 1: Create an application

While authenticated to your Twitter account, reach this page:

And Create a new app: name/description are not important, but you may need to put a valid website. Leave "Callback URL" blank.

Step 2: Generate an access token

In your freshly new app page, go to the tab called "Keys and Access Tokens".

Then click on "Create my access token" at the bottom.

Step 3: Plugin configuration

You now have everything required to set up shaarli2twitter plugin.



This setting shows the format of tweets. You can use placeholders which will be filled until the 280 chars limit is reached. Values may be truncated if the limit is reached.

Available placeholders, in order of priority:

  • ${url}: Shaare URL (will be automatically replaced as links).
  • ${permalink}: Shaare permalink (will be automatically replaced as links).
  • ${title}: Shaare title.
  • ${tags}: List of shaare tags displayed as hashtags (#tag1 #tag2...).
  • ${description}: Shaare description.

Default format: #Shaarli: ${title} ${url} ${tags}

Which will render, for example as:

#Shaarli: Wikipedia, the free encyclopedia #crowdsourcing #knowledge


Hide ${url} and/or ${permalink} when sharing a note to long to hold in a tweet.

Values: yes to hide URL or no to keep them. Default value is no.


MIT License, see


Automatically tweet your links from Shaarli




No packages published

Contributors 4