diff --git a/CHANGELOG.md b/CHANGELOG.md index cc7420f..bb7e9eb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,7 @@ # Changelog +**13 MAR 2023** VERSION 3.2.2 Updated list of nitter instances + **21 FEB 2023** VERSION 3.2.1 Updated user agents and list of nitter instances **15 FEB 2023** VERSION 3.2 Added mitigation for Mastodon API error 422, 'Unprocessable Entity', diff --git a/README.md b/README.md index d1c6705..500520b 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,11 @@ Twoot is a python script that mirrors tweets from a twitter account to a Mastodon account. It is simple to set-up on a local machine, configurable and feature-rich. -**13 MAR 2023** VERSION 3.2.2 Updated list of nitter instances +**19 JUN 2023** VERSION 3.3 + +* Added option to update avatar and banner pictures on profile if changed on Twitter +* Tweaked list of nitter instances +* Updated list of user agents > Previous updates can be found in CHANGELOG. @@ -17,6 +21,7 @@ It is simple to set-up on a local machine, configurable and feature-rich. * Specify maximum age of tweet to be considered * Specify minimum delay before considering a tweet for upload * Remember tweets already tooted to prevent double posting +* Optionally update avatar and banner pictures on profile if changed * Optionally post reply-to tweets on the mastodon account * Optionally ignore retweets * Optionally remove redirections (e.g. reveal destination of short URLs) @@ -29,9 +34,9 @@ It is simple to set-up on a local machine, configurable and feature-rich. ## Usage ```sh -twoot.py [-h] [-f <.toml config file>] [-t ] [-i ] - [-m ] [-p ] [-r] [-s] [-l] [-u] [-v] [-o] - [-a ] [-d ] [-c ] +usage: twoot.py [-h] [-f <.toml config file>] [-t ] [-i ] + [-m ] [-p ] [-r] [-s] [-l] [-u] [-v] [-o] [-q] + [-a ] [-d ] [-c ] ``` ## Arguments @@ -48,6 +53,7 @@ is sd@example.com on instance masto.space: | -p | Mastodon password | `my_Sup3r-S4f3*pw` | Once at first run | | -v | Upload videos to Mastodon | *N/A* | No | | -o | Do not add "Original tweet" line | *N/A* | No | +| -q | Update avatar and banner on profile if changed | *N/A* | No | | -r | Post reply-to tweets (ignored by default) | *N/A* | No | | -s | Skip retweets (posted by default) | *N/A* | No | | -l | Remove link redirections | *N/A* | No | @@ -71,22 +77,30 @@ to use, all the other command-line parameters are ignored, except `-p` (password ### Removing redirected links -`-l` will follow every link included in the tweet and replace them with the url that the -resource is directly dowmnloaded from (if applicable). e.g. bit.ly/xxyyyzz -> example.com -Every link visit can take up to 5 sec (timeout) therefore this option will slow down -tweet processing. +`-l` (or `remove_link_redirections = true` in toml file) will follow every link included in the +tweet and replace them with the url that the resource is directly dowmnloaded from (if applicable). +e.g. bit.ly/xxyyyzz -> example.com +Every link visit can take up to 5 sec (timeout) depending on the responsiveness of the source +therefore this option will slow down tweet processing. -If you are interested by tracker removal (`-u`) you should also select redirection removal -as trackers are often hidden behind the redirection of a short URL. +If you are interested by tracker removal (`-u`, `remove_trackers_from_urls = true`) you should +also select redirection removal as trackers are often hidden behind the redirection of a short URL. ### Uploading videos -When using the `-v` switch consider: +When using the `-v` (`upload_videos = true`) switch consider: * whether the copyright of the content that you want to cross-post allows it * the storage / transfer limitations of the Mastodon instance that you are posting to * the upstream bandwidth that you may consume on your internet connection +### Updating profile + +If `-q` (`update_profile = true`) is specified, twoot will check if the avatar and banner pictures +have changed on the twitter page. This check compares the name of files used by twitter with the names +of the files that have been uploaded on Mastodon and if they differ both files are downloaded from +twitter and uploaded on Mastodon. The check is very fast if there is no update. + ### Rate control Default max age is 1 day. Decimal values are OK.