fb-birthday-gratulator

Automatically post birthday messages to the Facebook profile wall of your friends.

Installation

Use git's tag v1.0.0 for the old, the tag v2.0.0 for the new Facebook design. The tag v3.0.0 and up is for a new execution method including a config command. Up of v4.0.0, you will also have additional config possibilities and pptr was changed for playwright.

Note that you need to set the language of Facebook to English for this to work out of the box.

Via Repo

Download this repository, unpack it. Make sure you have Node.js installed. Then, from the root of this repo/directory, run yarn install (make sure to have yarn installed) to run.

Via NPM/yarn

Install this repo like: npm install --global fb-birthday-gratulator

(replace npm install with yarn add if you do not belong to the mainstream)

Configuration

A file named config.json in the root of the directory, in which this tool has been installed to, can be used for the configuration. The content of the config.json have the structure (replace strings as appropriate):

{
  "username": "your@email.com",
  "password": "your/pass/word!",
  "wishes":  {
    "anyone": [
      "Happy birthday! ;D",
      "Happy birthday! 🥳🎈🎁🎊🥳",
      "Best wishes & many presents! 🎁🎊🎁"
    ],
    "Your Loved Ones FB-Name": [
      "Enjoy your day, my Love! 😘💕❤️"
    ]
  }
}

Note that at the moment, the config is not getting validated in any useful form – you will just get the failure notification.

Usage

$ npm install -g fb-birthday-gratulator
$ fb-gratulate COMMAND
running command...
$ fb-gratulate (-v|--version|version)
fb-birthday-gratulator/4.0.9 darwin-x64 node-v17.7.1
$ fb-gratulate --help [COMMAND]
USAGE
  $ fb-gratulate COMMAND
...

Commands

• fb-gratulate config
• fb-gratulate congratulate
• fb-gratulate help [COMMAND]

fb-gratulate config

Generate or edit a config - interactively

USAGE
  $ fb-gratulate config

DESCRIPTION
  ...
  This command lets you create a new config if none exists interactively 
  or opens lazily an editor to let you edit the existing config.

See code: src/commands/config.js

fb-gratulate congratulate

Congratulate all todays birthday friends

USAGE
  $ fb-gratulate congratulate

OPTIONS
  -d, --debug
  -h, --help     show CLI help
  -v, --version  show CLI version

DESCRIPTION
  ...
  Note that you require a config as described [here](https://github.com/GenieTim/fb-birthday-gratulator#configuration)

ALIASES
  $ fb-gratulate gratulate

See code: src/commands/congratulate.js

fb-gratulate help [COMMAND]

Display help for fb-gratulate.

USAGE
  $ fb-gratulate help [COMMAND]

ARGUMENTS
  COMMAND  Command to show help for.

OPTIONS
  -n, --nested-commands  Include all nested commands in the output.

See code: @oclif/plugin-help

Automation

Use a separate program, such as a cron, to execute this utility daily.

License