Introduzione

📦 Meli-Action

Uno strumento basato su GitHub Actions per bypassare la censura di Internet — scarica file da link diretti, YouTube, Telegram, Google Play, SoundCloud e archivia pagine web, tutto attraverso server non censurati di GitHub.

Come funziona?

GitHub Actions sono eseguite sui server di GitHub, che non sono bloccati dalla censura nazionale iraniana. Questo progetto sfrutta questa caratteristica:

• Per scaricare file: il workflow usa wget per scaricare file nell'ambiente runner di GitHub, quindi li aggiunge al tuo repository tramite git push, pronti per essere scaricati normalmente da GitHub.
• Per archiviare pagine web: un browser headless Chromium (usando pyppeteer) rende completamente la pagina bloccata, la salva in formato MHTML, la comprime in zip e la aggiunge al repository.
• Per YouTube, Telegram, SoundCloud e Google Play: workflow dedicati usano yt-dlp e strumenti specifici di ogni piattaforma per scaricare i file nella cartella downloads/ e committarli.

Non è richiesto alcun software installato sul tuo dispositivo; tutto si esegue nel cloud.

Caratteristiche

Installazione

Passaggio 1 — Effettua il fork

Clicca il pulsante Fork sopra per copiare il repository sul tuo account GitHub.

Passaggio 2 — Abilita permessi di scrittura per le action

I workflow devono poter committare i file scaricati nel tuo repository:

1. Nel repository forkato, vai su Settings ⚙️.
2. Dal menu a sinistra scegli Actions → General.
3. Sotto "Workflow permissions", seleziona "Read and write permissions".
4. Clicca Save.

Inoltre, sotto "Actions permissions", assicurati che "Allow all actions and reusable workflows" sia abilitato.

💡 Nota di sicurezza: Poiché il fork è tuo, dare permessi di scrittura alle tue workflow è sicuro.

Passaggio 3 — Esegui un workflow

1. Vai alla scheda Actions nel tuo repository.
2. Seleziona il workflow desiderato dalla lista a sinistra (es. "Download da URL", "Downloader YouTube", ecc).
3. Clicca su Run workflow.
4. Inserisci i parametri richiesti (URL, qualità video, cartella output).
5. Premi il pulsante verde Run workflow.

Al termine, il file scaricato sarà presente nella cartella selezionata nel repository, pronto per essere scaricato da GitHub.

Struttura del repository

Meli-Action/
├── .github/
│   └── workflows/          # Definizione dei workflow GitHub Actions
│       ├── download.yml        # Downloader link diretto
│       ├── youtube.yml         # Downloader YouTube
│       ├── telegram.yml        # Downloader Telegram
│       ├── googleplay.yml      # Downloader Google Play
│       ├── mhtml.yml           # Archivia web pages
│       └── ...
├── downloads/              # Cartella output — file scaricati conservati qui
├── save_as_mhtml.py        # Script Python per archiviazione pagine con browser headless
├── google_service.json     # Configurazione v2ray per browsing YouTube tramite proxy
└── README.md

Dettagli tecnici

Downloader da link diretto

Utilizza wget all'interno del runner GitHub Actions. Se il file supera i 100 MB (limite GitHub), viene automaticamente diviso in porzioni da massimo 95 MB e ogni porzione viene committata separatamente.

Archiviazione pagine web (save_as_mhtml.py)

Utilizza pyppeteer (la versione Python di Puppeteer) per avviare un browser Chromium headless, andare all'URL specificato, attendere il caricamento completo della pagina e salvarla in formato MHTML. L'archivio finale è zipperato e committato nel repository.

Downloader YouTube

Si avvale di yt-dlp e supporta la scelta della qualità (es. 720p, 1080p, solo audio). Il file google_service.json può essere importato nel v2ray per permettere ricerca e visualizzazione thumbnail YouTube tramite proxy.

Downloader Telegram

Targettizza solo canali pubblici Telegram. Scarica gli allegati dei messaggi usando l'API pubblica di Telegram.

Downloader Google Play

Scarica file APK da Google Play usando strumenti di automazione.

Aggiornamento alla versione più recente

Per sincronizzare il tuo fork con le ultime versioni del repository originale, clicca il pulsante Sync fork nella pagina principale del tuo repository su GitHub.

Contribuire

Hai un'idea per un nuovo downloader o una nuova funzionalità? Apri un Issue e scrivi la tua proposta. Non garantiamo l'implementazione, ma se interessante sarà certamente considerata.

Disclaimer

Questo progetto è pensato per uso personale per accedere a contenuti in reti con restrizioni. Gli utenti sono responsabili di rispettare i termini di servizio delle piattaforme coinvolte e le leggi del loro paese.

Supporto

Se lo strumento ti è utile, metti una ⭐ per supportare il progetto e facilitarne la visibilità!