explaingit

jsha/blocktogether

Analysis updated 2026-07-16 · repo last pushed 2022-03-10

322JavaScriptAudience · generalComplexity · 4/5DormantSetup · hard

TLDR

Block Together helps Twitter users fight harassment by sharing block lists. One person blocks abusers, then others subscribe to instantly apply those same blocks to their own accounts.

Mindmap

mindmap
  root((repo))
    What it does
      Share block lists
      Subscribe to blocks
      Apply blocks for you
    Use cases
      Protect communities
      Fight coordinated harassment
      Save time blocking
    Tech stack
      JavaScript
      MySQL or MariaDB
      Vagrant
      Twitter API
    Audience
      Journalists
      Activists
      Marginalized groups
    Setup
      Create Twitter app
      API keys needed
      Database required

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Share your block list with a community so everyone can subscribe and block harassers in one step.

USE CASE 2

Subscribe to a trusted person's block list to instantly protect your account from known abusers.

USE CASE 3

Help a marginalized group defend against coordinated harassment by curating a shared block list.

What is it built with?

JavaScriptMySQLMariaDBVagrantTwitter API

How does it compare?

jsha/blocktogethershopify/shopify-ai-toolkitjxlarrea/voice-satellite-card-integration
Stars322322321
LanguageJavaScriptJavaScriptJavaScript
Last pushed2022-03-10
MaintenanceDormant
Setup difficultyhardeasymoderate
Complexity4/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires creating a Twitter developer app with read and write permissions, plus configuring a MySQL or MariaDB database and Vagrant environment.

No license information is provided in the repository, so default copyright restrictions apply and you should contact the author before using it.

In plain English

Block Together is a tool designed to help Twitter users deal with harassment and abuse. It lets you share your list of blocked accounts with other people, and subscribe to block lists that others have shared. The core idea is that if someone is harassing people in a particular community, one person can block the harasser and then share that block with everyone else, so the whole group can quickly protect themselves without each person having to identify and block the abuser individually. At a high level, the app connects to your Twitter account through Twitter's official API. Once connected, it can apply blocks, unblocks, and mutes on your behalf. When you subscribe to someone else's block list, the app takes the accounts they've blocked and applies those same blocks to your account. This is why it needs read and write access to your Twitter account, without write permission, it couldn't actually block anyone for you. The people who would benefit most from this are communities that face coordinated harassment on Twitter, for example, journalists, activists, game developers, or marginalized groups who are frequently targeted. If a group of people is being harassed by the same set of accounts, one trusted member can curate a block list and share it, and the rest can subscribe rather than each person having to track down and block every harasser themselves. It's essentially a crowdsourced defense mechanism against abuse. Setting it up requires creating your own Twitter app with read and write permissions, which involves registering a developer application through Twitter and plugging in API keys. The project uses a database (MySQL or MariaDB) to store block data, and the setup instructions recommend using Vagrant, which is a tool that creates a consistent development environment so you don't have to worry about configuring everything manually on your own machine.

Copy-paste prompts

Prompt 1
Set up Block Together for a community of journalists facing coordinated harassment on Twitter. Walk through creating the Twitter developer app, configuring API keys, and starting the server with Vagrant.
Prompt 2
I want to subscribe to an existing shared block list in Block Together. How do I connect my Twitter account and subscribe to a list so those blocks are applied to my account automatically?
Prompt 3
Explain how Block Together applies blocks from a shared list to my Twitter account. What happens when new accounts are added to a list I've subscribed to?
Prompt 4
Help me configure MySQL and Vagrant for a local Block Together development environment. What database setup steps are needed before I can run the app?

Frequently asked questions

What is blocktogether?

Block Together helps Twitter users fight harassment by sharing block lists. One person blocks abusers, then others subscribe to instantly apply those same blocks to their own accounts.

What language is blocktogether written in?

Mainly JavaScript. The stack also includes JavaScript, MySQL, MariaDB.

Is blocktogether actively maintained?

Dormant — no commits in 2+ years (last push 2022-03-10).

What license does blocktogether use?

No license information is provided in the repository, so default copyright restrictions apply and you should contact the author before using it.

How hard is blocktogether to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is blocktogether for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.