Procedurally generated obituaries.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


GitHub issues GitHub license

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


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.


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.


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.


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:


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


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.


ObitBot itself is open source, licensed under the MIT license.