Facebook Online-status Logger

Quite a little privacy red-pill.

Installation

First, clone this repository to your server/computer:

$ git clone https://github.com/fluxTH/fb-logger.git

Next, install the required dependencies using pip:

$ pip3 install -r requirements.txt

Now, create your config.json file from the example provided:

$ cd fb-logger/
$ cp config.json.example config.json

Edit your config file with your Facebook credentials in the credentials section.

cuser refers to your Facebook numeric ID
xs refers to your Facebook xs cookie value
- Warning: Take note of your cookie expiration date, as you'll need to update your xs with new value when it expires.

fb-logger is designed to run as a long-running process, currently daemon mode is not supported, yet.

This program saves all your acquired data to fblog.db file.

To start your logger, run:

$ python3 fblogger.py

When you want your logger to run even when the terminal window is closed, use:

$ python3 fblogger.py > /dev/null &

Notice that this command won't output anything to STDOUT, this is where the fblogger.log file comes in.

To stop the logger, use CTRL + C in normal mode. In long-running mode, use:

$ kill -9 $(cat fblogger.pid)

All the configuration options available in config.json, refer to config.json.example for default values.

Key	Type	Description
`debug`	Boolean	(Not Implemented) Enable debugging functionalities.
`database`	String	*Required.* Path to database file.
`pid_file`	String	Path to file containing PID.
`log_file`	String	Path to runtime log file.

Key	Type	Description
`credentials.c_user`	String	*Required.* Facebook numeric ID.
`credentials.xs`	String	*Required.* Value of `xs` cookie on Facebook web.

Key	Type	Description
`secrets.brunca`	String	(Not Implemented) Secret encryption key for brunca tokens. (32 bytes)
`secrets.flask`	String	*Required.* Web GUI secret encryption key.

Key	Type	Description
`scraper.cache_lb`	Boolean
`scraper.sticky_expire`	Integer	Seconds to invalidate sticky cookie cache.
`scraper.longpoll`	Boolean	(Not Implemented) Enables longpolling.
`scraper.longpoll_timeout`	Boolean	(Not Implemented) Seconds to wait for a longpoll request.
`scraper.poll_interval`	Integer	Seconds to wait until new full request. (Not used if in longpoll mode)
`scraper.request_timeout`	Integer	Seconds to wait for a full request.
`scraper.retry_timeout`	Integer	Seconds to wait before trying again in case of error.
`scraper.retry_limit`	Integer	Limit of failed retry attempts.
`scraper.chill_timeout`	Integer	Seconds to wait if retry attempt reached limit.