Fetch Facebook Birthdays events and create an ICS file for use with calendar apps
Facebook Birthday Events to ICS file converter
Around 20 June 2019, Facebook removed their Facebook Birthday ICS export option.
This change was unannounced and no reason was ever released.
fb2cal is a tool which restores this functionality.
It works by calling endpoints that power the https://www.facebook.com/events/birthdays/ page.
After gathering a list of birthdays for all the users friends for a full year, it creates a ICS calendar file. This ICS file can then be imported into third party tools (such as Google Calendar or Apple Calendar).
git clone [email protected]:mobeigi/fb2cal.git
config/config-template.ini
to config/config.ini
and enter your Facebook email and password (no quotes).pipenv install
fb2cal
modulepipenv run python -m fb2cal
out
by default) for the created birthdays.ics
fileThis tool can be configured by editing the config/config.ini
configuration file.
Section | Key | Valid Values | Description |
---|---|---|---|
AUTH | fb_email | Your Facebook login email | |
fb_password | Your Facebook login password | ||
FILESYSTEM | save_to_file | True, False | If tool should save ICS file to the local file system |
ics_file_path | Path to save ICS file to (including file name) | ||
LOGGING | level | DEBUG, INFO, WARNING, ERROR, CRITICAL | Logging level to use. Default: INFO |
It is recommended to run the script once every 24 hours to update the ICS file to ensure it is synchronized with the latest Facebook changes (due to friend addition/removal) and to respect the privacy of users who decide to hide their birthday later on. Facebook originally recommended polling for birthday updates once every 12 hours based on the X-PUBLISHED-TTL:PT12H
header included in their ICS files.
pipenv install
fb2cal
modulepipenv run python -m pip install .
unittests
module on the tests
folderpipenv run python -m unittest discover tests
If you encounter any issues, please open the config/config.ini
configuration file and set the LOGGING
level
to DEBUG
(it is INFO
by default). Include these logs when asking for help.
Contributions are always welcome! Just make a pull request.
GNU General Public License v3.0