https://github.com/manualdousuario/marreta
Uma ferramenta que quebra barreiras de acesso e elementos que atrapalham a leitura! / Marreta is a tool that removes access barriers and visual distractions!
https://github.com/manualdousuario/marreta
bypasser paywall paywall-bypasser
Last synced: 5 months ago
JSON representation
Uma ferramenta que quebra barreiras de acesso e elementos que atrapalham a leitura! / Marreta is a tool that removes access barriers and visual distractions!
- Host: GitHub
- URL: https://github.com/manualdousuario/marreta
- Owner: manualdousuario
- License: gpl-3.0
- Created: 2024-11-22T18:06:47.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-28T23:46:15.000Z (8 months ago)
- Last Synced: 2025-12-01T01:49:25.186Z (8 months ago)
- Topics: bypasser, paywall, paywall-bypasser
- Language: PHP
- Homepage: https://marreta.pcdomanual.com/
- Size: 3.24 MB
- Stars: 1,075
- Watchers: 8
- Forks: 42
- Open Issues: 1
-
Metadata Files:
- Readme: README.en.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 🛠️ Marreta
[](https://github.com/manualdousuario/marreta/blob/master/README.md)
[](https://github.com/manualdousuario/marreta/blob/master/README.en.md)
[](https://www.php.net/)
[](https://hub.docker.com/r/manualdousuario/marreta)
[](https://github.com/manualdousuario/marreta/network/members)
[](https://github.com/manualdousuario/marreta/stargazers)
[](https://github.com/manualdousuario/marreta/issues)
Marreta is a tool that breaks access barriers and elements that hinder reading!

Public instance at [marreta.pcdomanual.com](https://marreta.pcdomanual.com)!
## ✨ What's Cool?
- Automatically cleans and corrects URLs
- Removes annoying tracking parameters
- Forces HTTPS to keep everything secure
- Changes user agent to avoid blocking
- Leaves HTML clean and optimized
- Fixes relative URLs on its own
- Allows you to add your own styles and scripts
- Removes unwanted elements
- Caching, caching!
- Blocks domains you don't want
- Allows configuring headers and cookies your way
- PHP-FPM and OPcache
- Proxy Support
## 🐳 Installing with Docker
Install [Docker and Docker Compose](https://docs.docker.com/engine/install/)
`curl -o ./docker-compose.yml https://raw.githubusercontent.com/manualdousuario/marreta/main/docker-compose.yml`
Now modify with your preferences:
`nano docker-compose.yml`
```
services:
marreta:
container_name: marreta
image: ghcr.io/manualdousuario/marreta:latest
ports:
- "80:80"
environment:
- SITE_NAME=
- SITE_DESCRIPTION=
- SITE_URL=
- LANGUAGE=
```
- `SITE_NAME`: Name of your Marreta
- `SITE_DESCRIPTION`: Explain what it's for
- `SITE_URL`: Where it will run, full address with `https://`. If you change the port in docker-compose (e.g., 8080:80), you must also include the port in SITE_URL (e.g., https://yoursite:8080)
- `SELENIUM_HOST`: Server:PORT of Selenium host (e.g., selenium-hub:4444)
- `LANGUAGE`: pt-br (Brazilian Portuguese), en (English), es (Spanish), de-de (German), ru-ru (Russian)
Now just run `docker compose up -d`
### More configurations:
- Selenium: https://github.com/manualdousuario/marreta/wiki/%F0%9F%92%BB-Selenium-Hub-(Chrome-and-Firefox)
- S3 Cache: https://github.com/manualdousuario/marreta/wiki/%F0%9F%97%83%EF%B8%8F-Cache-S3
- Maintenance: https://github.com/manualdousuario/marreta/wiki/%F0%9F%9B%A0%EF%B8%8F-Maintenance
### 🛡️ DMCA
To block domains from DMCA requests, create the file `app/cache/dmca_domains.json`:
```json
[
{
"host": "exemplo.com.br",
"message": "This content has been blocked on request"
}
]
```
## 🚀 Integrations
- 🤖 **Telegram**: [Official Bot](https://t.me/leissoai_bot)
- 🦊 **Firefox**: Extension by [Clarissa Mendes](https://claromes.com/pages/whoami) - [Download](https://addons.mozilla.org/en-US/firefox/addon/marreta/) | [Source Code](https://github.com/manualdousuario/marreta-extensao)
- 🌀 **Chrome**: Extension by [Clarissa Mendes](https://claromes.com/pages/whoami) - [Download](https://chromewebstore.google.com/detail/marreta/ipelapagohjgjcgpncpbmaaacemafppe) | [Source Code](https://github.com/manualdousuario/marreta-extensao)
- 🦋 **Bluesky**: Bot by [Joselito](https://bsky.app/profile/joseli.to) - [Profile](https://bsky.app/profile/marreta.pcdomanual.com) | [Source Code](https://github.com/manualdousuario/marreta-bot)
- 🍎 **Apple**: Integration with [Shortcuts](https://www.icloud.com/shortcuts/3594074b69ee4707af52ed78922d624f)
---
Made with ❤️! If you have questions or suggestions, open an issue and we'll help! 😉
Special thanks to the projects [Burlesco](https://github.com/burlesco/burlesco) and [Hover](https://github.com/nang-dev/hover-paywalls-browser-extension/) which served as the basis for many rules!
## Star History
[](https://star-history.com/#manualdousuario/marreta&Date)