browserboi 💻 👦

Headless browser automation service for things that we can't do with official APIs. Uses puppeter and chrome for browser automation.

Bots

• like youtube videos
• add youtube videos to watch later

Usage

You can install package via npm or use a docker image

Dependencies

• nodejs >=16
• google chrome or chromium

Installing package

npm install -g @xtruder/browserboi

Running

browserboi serve --headless --youtube-cookies cookies.json --token <optional auto token>

Starts a headless API on localhost:8080 protected by bearer auth with provided token

Using docker image

docker run \
  -e BROWSERBOI_HEADLESS=true \
  -e BROWSERBOI_YOUTUBE_COOKIES=/app/cookies.json \
  -e BROWSERBOI_TOKEN=<my secret token> \
  -p 8080:8080 \
  -v $PWD/cookies.json:/app/cookies.json \
  ghcr.io/xtruder/browserboi:latest serve

API

Swagger API documentation is avalible on http://localhost:8080/docs.

Example API call:

curl -XPOST localhost:8080/api/youtube/watchLater \
  -H 'Authorization: Bearer <auth token>'
  -d '{"url": "https://www.youtube.com/watch?v=gCJxvpo0dxY", "added": true}'

Obtaining youtube tokens

browserboi login-youtube --chrome-path chromium --output cookies.json

This will open chromium with login screen, after you login it will dump cookies to cookies.json

Development

• Install google chrome or chromium

• Clone and install dependencies

  git clone https://github.com/xtruder/browserboi.git
  npm install

• Obtain youtube access tokens

  browserboi login-youtube --chrome-path chromium --output cookies.json
  

• npm run dev

  This will start a chrome and development server on localhost:8080

VsCode remote container

This project already provides vscode development container that will start wayland rdp server, to which you can connect and visually debug your automation.

To connect to rdp server you need to first expose port 3389 from container usng vscode and then use any rdp client to connect to it.

Publish a new package

1. Bump a version

npm version <major/minor/patch/>
git push --tags

2. Release a new version via github

Author

Jaka Hudoklin jaka@x-truder.net @offlinehacker