Skip to content
πŸ¦πŸ”€πŸ—‘οΈ Keep or Sweep for Twitter
Branch: master
Clone or download
jancborchardt Adjust testimonial display
Signed-off-by: Jan-Christoph Borchardt <hey@jancborchardt.net>
Latest commit 5accab7 May 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
audio
css
images
js Merge remote-tracking branch 'origin/master' into random-of-all-tweets May 12, 2019
templates Improve randomness by fetching all Tweets ever initially May 12, 2019
vendor Improve randomness by fetching all Tweets ever initially May 12, 2019
.env.template First version based on TwitterOAuth demo site Apr 24, 2019
.gitignore
LICENSE
README.md Adjust testimonial display May 13, 2019
app.php
bootstrap.php First version based on TwitterOAuth demo site Apr 24, 2019
callback.php Fix callback denied page, just redirect to home again May 10, 2019
clearsessions.php Fix callback denied page, just redirect to home again May 10, 2019
composer.json First version based on TwitterOAuth demo site Apr 24, 2019
composer.lock First version based on TwitterOAuth demo site Apr 24, 2019
dev.sh First version based on TwitterOAuth demo site Apr 24, 2019
http.php First version based on TwitterOAuth demo site Apr 24, 2019
index.php First version based on TwitterOAuth demo site Apr 24, 2019
redirect.php
sweep.php Sweeping retweets will unretweet and also unfavorite them Apr 27, 2019
templates.php
tweet_ids.php

README.md

πŸ¦πŸ”€πŸ—‘οΈ Keep or Sweep for Twitter

Platforms like Twitter, Facebook and Instagram have your embarrassing old stuff that not even you know about anymore. Time to take a trip down memory lane and sweep it!

The app fetches all of a user’s Tweets from the Twitter API, randomizes, and displays them as embed one at a time to keep or sweep.

πŸ’¬ Testimonials

Every Nigerian politician needs this app so they can clean up their old lies.

– @enobong, 129+ Sweeps

Before I start using this, please remember that people can change.

– @hugoroyd, 41 sweeps

Aaah where's the funny stuff!?

– @madeline_oh, 29 sweeps

had a great meal: vegetables

– @pierreozoux (back in 2009), 27 sweeps

I used this app and my cryptocoins are all still there.

Trustworthy

– @mradwanz, 21 Sweeps

Very very fun! Can you do this with other people's accounts?

– @christalib_, 15 sweeps, including an accidental one

Ooh this is very empowering!

Marie Kondo would be proud of this app

– @saadcaffeine, 13 Sweeps

Insert testimonial here

– @myamy_vicy, 12 Sweeps

What do you think about Keep or Sweep? Let us know and include your Twitter username and Sweep score!

πŸ— Setup

  1. Register a Twitter app.
  2. Set http://localhost:8000/callback.php as a "Callback URL" in the newly registered application.
  3. Copy .env.template to .env.
  4. In .env, set the CONSUMER_KEY and CONSUMER_SECRET from your Twitter app.
  5. In a terminal, run composer install to install the dependencies.
  6. Then run ./dev.sh to start the server.
  7. Visit http://localhost:8000 in a browser.

🚦 Fixes and features

πŸ› Issues happening often

  • Embedded Tweets sometimes exceed viewport: Use max-height of embed or CSS to prevent overflow. β†’ Seems the embed parameters cards: 'hidden' or width: '550' are not honored?
  • People don’t know their passwords. We could possibly have a fallback where you just put in your username, and swept Tweets are added onto a list you could mail to yourself at the end.

πŸ“‘ Enhancements

  • People in the audience have difficulty reading the Tweets: Needs a bigger screen for presentation, external monitor or even projector. Vertical monitor would be perfect for display of Tweet embed.
  • Unclear when Tweets are Retweets: Needs a better indicator for Retweets.
  • Sound effects not audible at crowded events: Need to be louder.
  • Sweeping could be more satisfying: Sound effects for spree sweeps (m-m-m-MONSTER SWEEP!) like in Unreal Tournament.
  • Possibly implement showing favorited Tweets too, with favorites/list and favorites/destroy. Needs additional indicator then.
  • Ability to undo last action would be nice. But in the case of sweeping we then need to hold off on actual deletion until the next action.

πŸ“œ Advanced stuff and details

  • Mouse cursor keeps showing when buttons are used: Hide mouse when in fullscreen and not moving.
  • Currently white screen when Twitter can’t be reached, instead show note about it (maybe also wifi is slow).
  • Could also display people you are following, to unfollow. However it’s a level above (kind of a "collection" and not a single element) and thus there’s less context there.
  • Super like / Love: Additional button which retweets and likes the Tweet, even if it is your own.
  • Global high score table of sweep counter β†’ maybe just Tweet from @keeporsweep with messages like "Yeah! @username swept 12 Tweets using http://keeporsweep.net πŸ‘"
  • Keep or Sweep x Wahl-o-mat: Show anonymized tweets of politicians, and show a result screen of parties you most agreed with.

❀ Thanks

Based on the great TwitterOAuth PHP library and its demo site – thanks to Abraham Williams! πŸŽ‰

Using the official Twitter embedded Tweets, so it shows conversation as well as count of replies & likes for context.

You can’t perform that action at this time.