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": "[e-mail]",
  "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 (--version|-v)
fb-birthday-gratulator/4.1.2 darwin-x64 node-v22.1.0
$ fb-gratulate --help [COMMAND]
USAGE
  $ fb-gratulate COMMAND
...

Commands

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

fb-gratulate config

Generate or edit a config - interactively

USAGE
  $ fb-gratulate config [--version] [--help]

FLAGS
  --help     Show CLI help.
  --version  Show CLI version.

DESCRIPTION
  Generate or edit a config - interactively
  ...
  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 [--version] [-d] [--help]

FLAGS
  -d, --debug
      --help     Show CLI help.
      --version  Show CLI version.

DESCRIPTION
  Congratulate all todays birthday friends
  ...
  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 gratulate

Congratulate all todays birthday friends

USAGE
  $ fb-gratulate gratulate [--version] [-d] [--help]

FLAGS
  -d, --debug
      --help     Show CLI help.
      --version  Show CLI version.

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


ALIASES
  $ fb-gratulate gratulate

fb-gratulate help [COMMAND]

Display help for fb-gratulate.

USAGE
  $ fb-gratulate help [COMMAND...] [-n]

ARGUMENTS
  COMMAND...  Command to show help for.

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

DESCRIPTION
  Display help for fb-gratulate.

See code: @oclif/plugin-help

fb-gratulate version

USAGE
  $ fb-gratulate version [--json] [--verbose]

FLAGS
  --verbose  Show additional information about the CLI.

GLOBAL FLAGS
  --json  Format output as json.

FLAG DESCRIPTIONS
  --verbose  Show additional information about the CLI.

    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.

See code: @oclif/plugin-version

Automation

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

License