Skip to content

vincentshadow/better-angels

 
 

Repository files navigation

Better Angels' Buoy: A community-driven emergency dispatch system powered by friendship.

Branch Builds
master Build Status for master branch
develop Build Status for develop branch

Buoy is a private, enhanced 9-1-1 for your website. It is free software created by the Better Angels collective as a WordPress plugin and is designed to quickly connect people in need with trusted friends, family members, advocates, and other allies in times of crisis.

One can imagine the Internet as a vast ocean, its many users as people sailing to the many ports on the high seas. Buoy is software that equips your website with tools that your users can use to help one another in the real world. The more buoys are deployed on the ocean, the safer traveling becomes for everyone.

—The Better Angels

For service providers

Anyone with a WordPress-powered website or blog can add the Buoy software (a 1-click automatic install) to their website, instantly enabling the site's membership to provide peer-based mutual-aid to one another. Moreover, legal aid service providers, domestic, dating, and intimate partner violence prevention advocates, shelters, social groups, alternative medical and mental health collectives, and others can offer members of their community one-click emergency access to a network of trusted peers and/or on-call emergency responders.

For victims and survivors

Buoy makes it easy to tell your friends where you are and what you need, even in the most dangerous or frightening scenarios. Tapping a single button will immediately notify the people you trust most that you need their help, give them a map showing your exact location, and even helps them coordinate with one another to quickly figure out how to help you best. With Buoy and a smartphone, you are never more than one button press away from the people you trust most. (We are even working to support old-school flipfones!)

You do not need to download or install special software to use Buoy. Simply bookmark a page with your smartphone's built-in Web browser to gain instant access to your personal emergency response team. Quickly send them your location with a pre-defined custom message, write a custom message, or schedule a timed alert (like a "safe call") for some time in the future.

The people you select as your emergency contacts ("response team") will get a notification showing them your location in the real world as well as the locations of any other responders to your call for help. If it's safe for you to do so, you can now coordinate with all responders in a live chat room, or responders can coordinate amongst themselves about how best to help you if you are unresponsive.

See the screenshots for an example walkthrough of how Buoy works.

Find a Buoy-enabled web site.

Installing Buoy for your community

Installation is as simple as pressing "Install now" from your admin WordPress Dashboard. (Learn more about installing WordPress plugins from WPBeginner.com.) You can also find Buoy hosted on the WordPress plugin repository.

Read the Buoy Administration Guide for more details.

Contributing

Buoy is free software. It was developed and is maintained primarily by a nomadic hacker named maymay who has a lot of fucks to give about supporting survivors of any of capitalism's horrors, along with a growing group of volunteers who call themselves the Better Angels.

Even if you don't code, there's a lot you can do to help make Buoy better. Here are a few.

Donate

You can support development and maintenance of Buoy by supporting its primary developer, maymay. Click here to donate via PayPal, or visit Cyberbusking.org for maymay's personal donation portal.

You can also support development of Buoy by supporting the following organizations who have helped make Buoy possible:

Translate

If you speak multiple languages, you can help translate Buoy into more human languages. This helps make Buoy available to people all over the world in their native languages.

Document

If you use Buoy and are familiar with how it works, you can help others learn about the tool by writing about how you use it. We maintain a wiki that you can edit to add your own guides, walkthroughs, and suggestions.

You can also write articles on your website or blog. If you do, please contact us or email maymay directly to let us know.

Code

The easiest way to get started contributing code is to use the Varying Vagrant Vagrants ("VVV") project to make a local WordPress development environment. Then fork the Buoy project on GitHub and git clone your fork into your VVV's wordpress-default/wp-content/plugins/ directory. See our wiki for a step-by-step guide to setting up a development environment.

Patches and pull requests are very welcome!

About

A private, community-based crisis response system. Buoy is an enhanced 9-1-1 for your personal community.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 78.6%
  • CSS 10.0%
  • JavaScript 9.2%
  • Shell 1.3%
  • HTML 0.9%