Skip to content

codemacabre/obitbot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ObitBot

License: Hippocratic 3.0

NOTE: ObitBot has been temporarily deactivated. It will return after some maintenace and added functionality in the near future.

Overview

ObitBot is a Twitter bot created using Node.js and Processing to post procedurally generated obituaries.

The obituaries ObitBot tweets are based on real mortality data, highlighting the rates of death by cause worldwide. ObitBot provides us with a constant (fictional) feed designed to mirror our own species' deaths (albeit at a greatly decreased rate to comply with Twitter API limits).

These fictional obituaries are assigned a procedurally generated tombstone, making ObitBot a virtual cemetery and a place to confront, and reflect upon, our inevitable demise.

Data

ObitBot's obituaries are procedurally generated using probabilities calculated from the WHO Mortality Database. Data is retrieved from all reporting countries using the latest available year (as of November 2016). This data is categorised into ICD-10 code chapters and divided by gender.

Changes

ObitBot originally composed tweets using names randomly selected using Behind the Name API. Gender was randomly selected and a single forename and surname were retrieved accordingly.

This functionality was added with the sole intention of making the obituaries seem real and give them a hint of humanity. Names have been removed as of v1.2.0 for several reasons, primarily to avoid the risk of randomly generating a real name and potentially being insensitive, distressing or even triggering for readers.

Usage

ObitBot requires the twit Node package to be installed in the node_modules subdirectory to communicate with Twitter.

The bot can be run using the following command:

$ node bot.js

API keys are required to interact with Twitter. These should be saved in the file config.js (not contained in this repo for obvious security reasons). Use the following formats:

config.js

module.exports = {
  consumer_key:         'YOUR-KEY-HERE',
  consumer_secret:      'YOUR-KEY-HERE',
  access_token:         'YOUR-KEY-HERE',
  access_token_secret:  'YOUR-KEY-HERE',
  timeout_ms:           60*1000
}

Disclaimer

A disclaimer was attached to the original version of this bot, reading as follows:

ObitBot's obituaries are fictitious. Any resemblance to actual persons (living or deceased) is unintentional and should not be inferred.

As the tweets posted by current version of ObitBot are more abstract and less personalised, I feel there is less chance of provoking an upsetting response, however, the above disclaimer remains true in all future versions of this bot.

This file only provides basic usage information and it is outside of the scope of this repo to provide additional support. I highly recommend following Daniel Shiffman's Twitter Bot Tutorial series to learn more.

License

ObitBot s ethical open source software, offered under the Hippocratic License 3.0, a permissive license that enforces the licensee to comply with human rights principles and laws.

Other software packages and libraries used fall under their own respective licenses.