PHPackages                             decidedly/friend-retweet - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. decidedly/friend-retweet

ActiveLibrary[Utility & Helpers](/categories/utility)

decidedly/friend-retweet
========================

Automatically retweet tweets of the people we're following

1.0.10(11y ago)03MITPHP

Since Feb 15Pushed 11y ago1 watchersCompare

[ Source](https://github.com/Decidedly/FriendRetweet)[ Packagist](https://packagist.org/packages/decidedly/friend-retweet)[ RSS](/packages/decidedly-friend-retweet/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (2)Versions (10)Used By (0)

FriendRetweet
=============

[](#friendretweet)

**FriendRetweet** is a command-line PHP script that allows you to automatically retweet the most popular tweets of the people you're following. Each time the app is run, it will scan your home timeline and retweet the most popular tweet since the last time it was run. Settings options exist to allow it to use old-school retweets instead of new retweets, as well as to go back as far in time as Twitter API will let us.

Download
--------

[](#download)

Download the script here:

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

[](#installation)

1. Create a Twitter app for yourself at . Make sure you create an access token and set your permissions to read-write as well.
2. `php composer install`
3. `cp config/example.config config/username.config`
4. Configure the app as follows:

    | Config Key | Description | | ----------------------------------------------| | `consumer_key` | Your Twitter consumer key | | `consumer_secret` | Your Twitter consumer secret | | `access_token` | Your Twitter access token | | `access_token_secret` | Your Twitter access token secret | | `twitter_user_id` | Your numeric Twitter User id. | | `memory_filename` | A path to the file where your user's data will be stored. These files don't generally get very big. | | `native_retweets` | A value of **true** causes native tweets, a values of **false** causes us to simply tweet the same text as the source tweet. | | `grab_tweets_since_last_run` | A value of **true** causes only tweets since the last time the app was run to be considered for retweets. Otherwise, all tweets in timeline will be considered. | | `include_friends_retweets` | A value of **false** causes only tweets by people we follow to be considered, but does exclude items that they themselves retweeted (ie things that they didn't post themselves). | | `enabled` | When this is set to **false**, we don't run. |

Running the App
---------------

[](#running-the-app)

From the command-line, type this:

`php FriendRetweet.php --config configs/username.config`

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

9

Last Release

4078d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/852d2f7a66b0b345c04bc681a20ab118b2ae9fa1b614000b7f6405fce9d44f79?d=identicon)[dhilowitz](/maintainers/dhilowitz)

---

Top Contributors

[![dhilowitz](https://avatars.githubusercontent.com/u/581406?v=4)](https://github.com/dhilowitz "dhilowitz (23 commits)")

### Embed Badge

![Health badge](/badges/decidedly-friend-retweet/health.svg)

```
[![Health](https://phpackages.com/badges/decidedly-friend-retweet/health.svg)](https://phpackages.com/packages/decidedly-friend-retweet)
```

###  Alternatives

[niels-de-blaauw/php-doc-check

Command line tool that identifies code that needs documentation.

43236.3k4](/packages/niels-de-blaauw-php-doc-check)[ecoapm/libyear

A simple measure of software dependency freshness

28302.5k](/packages/ecoapm-libyear)[pdir/social-feed-bundle

Social feed extension for Contao CMS

1414.8k](/packages/pdir-social-feed-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)