babeliocli-setup

name	babeliocli-setup
description	Install babeliocli, authenticate against Babelio (password or SSO cookie import), and manage the local session file. Use this skill when a user asks to install, log in, set up, connect, or recover a Babelio CLI session — including cases where the Babelio account is linked to Google or Facebook and a classic login is impossible.

babeliocli — Setup, Authentication, Session Management

babeliocli is a read-only CLI for babelio.com. It does not use an official API: instead, it logs into the regular web form (or reuses cookies from the user's browser) and parses HTML pages.

Install

One-liner (macOS or Linux, amd64 or arm64):

curl -fsSL https://raw.githubusercontent.com/yoanbernabeu/babeliocli/main/install.sh | sh

Or with Go:

go install github.com/yoanbernabeu/babeliocli@latest

Or grab a binary from the GitHub releases.

Authentication path 1 — username & password

babeliocli login --username 'pseudo_or_email'
# Password is prompted (hidden) unless --password-stdin or BABELIO_PASSWORD is set.

For scripts, prefer stdin so the password never appears on a process list:

printf '%s' "$BABELIO_PASSWORD" | babeliocli login --username "$BABELIO_USERNAME" --password-stdin

Environment variables: BABELIO_USERNAME, BABELIO_PASSWORD.

Authentication path 2 — SSO (Google / Facebook)

Babelio supports Google and Facebook login. babeliocli does not implement the full OAuth flow; instead, the user imports the cookies they already have in their browser.

1. User signs into babelio.com as usual.
2. User copies the following cookies from DevTools → Application → Cookies → https://www.babelio.com:
   • PHPSESSID
   • bbac
   • id_user
   • bbacml (optional)
3. Run:

babeliocli session import \
  --phpsessid 'XXX' \
  --bbac 'YYY' \
  --id-user 'NNN' \
  --username 'pseudo'

Or provide a JSON export from an extension like "EditThisCookie":

babeliocli session import --cookie-file cookies.json --username 'pseudo'

The session is verified by hitting /mabibliotheque.php and confirming we are not redirected to the login page.

Inspect and clear the session

babeliocli whoami   # shows username, id_user, saved_at
babeliocli logout   # removes ~/.config/babeliocli/session.json

The session file lives at $XDG_CONFIG_HOME/babeliocli/session.json (usually ~/.config/babeliocli/session.json on Linux/macOS) with mode 0600. Do not commit it to a repository.

Session expired?

If any read command returns session expired: run babeliocli login or babeliocli session import again, re-authenticate. Babelio's session TTL is finite, so expect periodic re-logins.

Output format

Every command defaults to JSON. Pass -f text for a readable terminal view. Errors go to stderr so that stdout stays valid JSON:

babeliocli whoami 2>/dev/null | jq .username

Troubleshooting

Symptom	Likely cause / fix
login failed: check username and password	Wrong credentials, or the account is SSO-only → use session import
imported cookies are not authenticated (redirected to login)	Cookies expired or copied wrong; re-copy from browser
no saved session (run babeliocli login first)	Nothing has ever been stored; run login or session import
Partial or garbled accents	Should not happen: the CLI handles ISO-8859-1. File a bug with the URL.