Byparr/README.md
2024-10-01 11:03:07 +02:00

2.1 KiB

Byparr

An alternative to FlareSolverr as drop-in replacement, build with nodriver and FastAPI.

Important

Currenly, due to bug in nodriver, if you run ouside of prebuild container, you have to run python fix_nodriver.py after creating venv.

Note

Thanks to FastAPI implementation, now you can also see the API documentation at /docs or / (redirect to /docs) endpoints.

Early Development

Long story short, I created it in like 3 days, so if you get any bugs/hangs etc. please report, so both of us can enjoy unblocked websites!

I focus maily on Cloudflare, which is tested daily, any other anti-bot challenges should pass out of the box, but if any issues, please report these providers with an example website ❤️

Troubleshooting

  1. Clone repo to the host that has the container has issues on.
  2. Using vscode and SSH extention, connect to the host and open repo in it.
  3. Download devcontainers extention and reopen repo in container (with CTRL + SHIFT + P -> Reopen in devcontainer)
  4. Open forwarded port from Ports tab in your browser to see emulated display
  5. Check if chrome works by running in VNCs terminal command chrome --no-sandbox
  6. If chrome works, run API by pressing F5 in vscode
  7. In Prowlarr (or target client) change port byparrs port to 8191 instead of 8181 (Port pointing to devcontainer)
  8. Check if everything works by testing byparr and observing VNC in browser

Usage

Docker Compose

services:
  byparr:
    image: ghcr.io/thephaseless/byparr
    environment:
      - LOG_LEVEL=INFO # optional
    ports:
      - "8191:8191" # Optional if used with *arr network

Need help with / TODO

  • Slimming container (~3GB bruh)
  • Add more anti-bot challenges
  • Add docstrings
  • Use tabs instead of sprawning new browsers
  • Implement versioning
  • Proxy support
  • Add more architectures support