AV-dwnldr

Què és

AV-dwnldr és un programa per descarregar vídeos i àudio de webs com YouTube.

La finestra és senzilla: enganxes l'enllaç, prems «Analitza», tries el format i prems «Descarrega».

Per dins fa servir yt-dlp. Quan una web canvia, una descàrrega pot fallar. Llavors el primer que cal fer és actualitzar yt-dlp, i ho expliquem més avall.

No funciona amb totes les webs, només amb les que yt-dlp sap llegir. El programa és lliure, amb llicència GPL-3.0, i està pensat per a Debian i Ubuntu. Si uses KDE Plasma, la finestra agafa el color d'accent del teu escriptori.

Abans de començar

L'ús que es faci del programa és responsabilitat de la persona que l'utilitza, i no de qui el desenvolupa.

Hi ha vídeos que no es poden baixar. El programa no fa servir la teva sessió iniciada, així que el contingut privat o amb restriccions d'edat queda fora. Si la web et demana que iniciïs sessió per veure el vídeo, en aquests casos el programa no el pot descarregar i t'ho indica.

Quan obres el programa per primera vegada, apareix un avís. Només cal tancar-lo, i després no torna a aparèixer:

Programari tal qual («as is»), sense garanties. No ens fem responsables de l'ús que se'n faci.

Instal·lació

Què necessites

• Debian stable o Ubuntu 26.04 LTS.
• Connexió a internet.
• La contrasenya que fas servir per iniciar sessió. La demanarà sudo quan instal·lis el programa.
• curl, per descarregar la clau del repositori. Si no el tens, instal·la'l amb sudo apt install curl.

Pas 1: afegeix el repositori (només cal fer-ho una vegada)

El paquet està signat. Aquestes ordres guarden la clau del repositori i l'afegeixen a apt, perquè el sistema accepti els seus paquets. No cal cap compte.

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://git.terata.org/api/packages/terata/debian/repository.key | sudo tee /etc/apt/keyrings/terata.asc > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/terata.asc] https://git.terata.org/api/packages/terata/debian stable main" | sudo tee /etc/apt/sources.list.d/terata.list > /dev/null

Copia les tres línies, enganxa-les en un terminal i prem Retorn. Et demanarà la contrasenya. Mentre l'escrius no es veu res: és normal.

Pas 2: instal·la el programa

sudo apt update
sudo apt install av-dwnldr

apt descarrega també el que el programa necessita, com FFmpeg.

Pas 3: instal·la yt-dlp

yt-dlp és el programa que descarrega els vídeos. Aquest pas el instal·la en una carpeta teva, sense permisos d'administrador. És obligatori: sense ell, el programa no s'obre.

av-dwnldr actualitzar

Quan acaba, mostra «Llest.». Si la pantalla diu que ~/.local/bin no és al PATH, tanca la sessió i torna a entrar. Després, av-dwnldr versio ha de mostrar un número de versió. Repeteix aquest pas quan vulguis actualitzar yt-dlp.

Pas 4: obre el programa

Obre «av-dwnldr» des del menú de l'escriptori, o escriu av-dwnldr en un terminal. A la primera obertura veuràs l'avís de l'apartat «Abans de començar». Si apareix «Falta l'entorn de yt-dlp», torna al pas 3.

La finestra, per parts

L'aplicació és una sola finestra. Aquestes són les seves zones, de dalt a baix:

Zona	Què hi veus	Per a què serveix
Barra de menús	«Eines» i «Ajuda»	«Eines» → «Actualitza yt-dlp» actualitza yt-dlp. «Ajuda» → «Sobre av-dwnldr» mostra la versió, la llicència i el repositori.
Barra superior	«av-dwnldr» a l'esquerra i «yt-dlp» amb un número a la dreta	El número és la versió de yt-dlp que fas servir.
Fila de l'enllaç	El camp «Enganxa l'enllaç del vídeo…», i els botons «Enganxa» i «Analitza»	«Enganxa» copia el text del portapapers al camp, però no l'analitza. «Analitza» llegeix la informació del vídeo.
Columna de l'esquerra	«FORMAT», «QUALITAT», «SUBTÍTOLS» i «CARPETA»	Tries què es descarrega i on es guarda.
Columna de la dreta	La miniatura o «sense miniatura», el títol, l'autor i la durada, i el botó «Registre»	Mostra el vídeo que has analitzat. «Registre» mostra o amaga el registre de l'aplicació.
Barra inferior	La barra de progrés, el text d'estat (com ara «Preparat»), i els botons «Cancel·la», «Obre la carpeta» i «Descarrega»	Segueix la descàrrega i fa les accions.

• Les opcions de l'esquerra canvien segons el format que tries (vegeu «Formats» i «L'opció Avançat»).
• El títol, l'autor i la durada apareixen quan analitzes un enllaç. Si és una llista de reproducció, la línia diu quants elements té i que només es descarrega el primer.
• «Descarrega» només s'activa quan l'anàlisi ha acabat. «Cancel·la» només està disponible mentre s'analitza o es descarrega.
• Mentre analitza o descarrega, el camp de l'enllaç i «Analitza» queden bloquejats. Durant la descàrrega, també queden bloquejades les opcions.
• Entre els controls de «CARPETA» i la barra de progrés hi ha una cara de color decorativa. No és un botó.

Com baixar un vídeo

1. Copia l'enllaç del vídeo des del navegador. Ha de començar per http:// o https://.
2. Enganxa'l al camp de dalt. Pots prémer «Enganxa» o usar Ctrl+V.
3. Prem «Analitza». Mentre analitza, la línia d'estat diu «Analitzant l'enllaç…». Quan acaba, diu «Preparat per descarregar», i a la dreta apareixen la miniatura, el títol, l'autor i la durada.
4. Tria el format, la qualitat i els subtítols, si els vols (vegeu «Formats»).
5. Si vols una altra carpeta, prem «Canvia la carpeta…» (vegeu «Carpeta i noms dels fitxers»).
6. Prem «Descarrega». La barra de progrés i la línia d'estat mostren el percentatge i, quan la plataforma els dona, la velocitat i el temps que falta. Si el format és Àudio o vídeo avançat, primer es baixa el vídeo i després es converteix: la línia d'estat diu «Convertint… N %».
7. Quan acaba, la línia d'estat diu «Fet: nom del fitxer». Si el sistema mostra notificacions, també apareix l'avís «Descàrrega completada: nom del fitxer». Prem «Obre la carpeta» per veure el fitxer.

Per cancel·lar, prem «Cancel·la»: la línia d'estat diu «Cancel·lant…» i després «Descàrrega cancel·lada» (o «Anàlisi cancel·lada», si estava analitzant). Si tanques la finestra durant una descàrrega, també es cancel·la. Només es pot fer una descàrrega alhora.

Formats

MP4 i MKV (vídeo simple)

Es baixen el vídeo i l'àudio tal com els publica la plataforma, i es junten en un fitxer MP4 o MKV. Quan la plataforma ofereix vídeo MP4 i àudio M4A, es junten sense recodificar.

• QUALITAT: 360p, 480p, 720p, 1080p o Màxima. Per defecte, 720p. És l'altura màxima: baixa la més alta que hi hagi fins a aquesta altura.
• SUBTÍTOLS: Cap (per defecte), ca, es o en. Si en tries un, s'incrusten dins del fitxer els subtítols que ha pujat la persona que ha fet el vídeo. Els subtítols automàtics no es baixen.
• MP4 és el format més compatible amb reproductors i mòbils. MKV admet més tipus de pistes i de subtítols.

Àudio

Només es baixa l'àudio, i es converteix amb el perfil que tries. Per defecte, MP3 192 kbps. Els perfils bàsics són:

• FLAC — Sense pèrdua (còpia exacta, fitxer pesat)
• MP3 128 kbps — qualitat bàsica, fitxer petit
• MP3 192 kbps — bona qualitat, ús general (per defecte)
• MP3 320 kbps — qualitat alta, gairebé transparent
• OGG Vorbis — qualitat baixa, fitxer molt lleuger
• OGG Vorbis — qualitat mitjana, equilibrat
• OGG Vorbis — qualitat alta, molt bon so
• MP3 192 kbps — volum anivellat (ideal per a veu i podcasts)

Quan tries Àudio, QUALITAT i SUBTÍTOLS desapareixen, perquè no s'hi apliquen.

L'opció Avançat

«Avançat» apareix en dos llocs, i cada casella només afecta el seu format:

• Amb Àudio, «Avançat» canvia la llista de perfils: 34 perfils en sis grups (MP3 · CBR, MP3 · VBR, OGG Vorbis, Opus, FLAC i WAV), en lloc dels 8 bàsics.
• Amb MP4 o MKV, «Avançat» activa el vídeo avançat. Apareix «FORMAT DE VÍDEO AVANÇAT» amb 22 perfils en sis grups (H.265 · MP4, VP9 · WebM, AV1 · WebM, ProRes · MOV, GIF i r_e_c_u_r). El perfil per defecte és «MP4 H.265/HEVC — CRF 23 (equilibri estàndard)».

Amb el vídeo avançat, el vídeo es baixa a la qualitat escollida i després es recodifica amb el perfil. Triga més que la descàrrega simple. El perfil avançat decideix el contenidor de sortida, per això MP4 i MKV es veuen en gris. Un clic a MP4 o MKV desmarca «Avançat» i torna al mode simple. Els subtítols no s'incrusten amb el vídeo avançat, i la casella de SUBTÍTOLS queda oculta.

Carpeta i noms dels fitxers

Per defecte, els fitxers es guarden en una subcarpeta «av-dwnldr» de la carpeta de vídeos de la sessió (normalment ~/Videos/av-dwnldr). Per canviar-la, prem «Canvia la carpeta…» i tria una altra. Es mostra un diàleg titulat «Carpeta de descàrregues», i el programa recorda l'elecció. «Obre la carpeta» crea la carpeta si no existeix i l'obre amb el gestor de fitxers.

Els noms dels fitxers són aquests:

• MP4 i MKV: <títol> [<identificador>].mp4 (o .mkv). Si el títol és molt llarg, es talla.
• Àudio i vídeo avançat: primer es baixa el vídeo en una carpeta temporal, .av-dwnldr-tmp, dins de la carpeta de destí. Després es crea el fitxer convertit amb el nom del perfil, com ara <títol> [<identificador>]_192kbps.mp3. La carpeta temporal s'esborra al final.
• Les conversions no sobreescriuen mai un fitxer. Si el nom ja existeix, el nou es diu «… (2)», «… (3)», i així successivament.

Actualitzacions

Hi ha dues coses que s'actualitzen per separat.

El programa. Obre un terminal i executa:

sudo apt update && sudo apt install --only-upgrade av-dwnldr

Et demanarà la contrasenya.

yt-dlp. Pots fer-ho de dues maneres:

• Des del menú «Eines» → «Actualitza yt-dlp». Mentre s'actualitza, la línia d'estat diu «Actualitzant yt-dlp…». Al final, un diàleg mostra la versió de yt-dlp abans i després. Si no s'ha pogut, mostra un avís amb les últimes línies de l'error. Si la versió ha canviat, reinicia av-dwnldr.
• Des d'un terminal, amb av-dwnldr actualitzar. Pots repetir-ho quan vulguis.

Quan una descàrrega falla i el missatge diu que yt-dlp pot estar desactualitzat, el primer pas és actualitzar-lo. El programa també t'ho pregunta quan passa. Si hi ha una anàlisi o una descàrrega en curs, el programa diu «Espera que acabi l'operació en curs.» i no actualitza yt-dlp.

Si alguna cosa falla

Missatge	Què vol dir	Què fer
«L'enllaç ha de començar per http:// o https://»	L'enllaç no és una adreça web completa.	Copia l'adreça completa des de la barra del navegador.
«El vídeo és privat.»	Només el pot veure qui hi té accés.	El programa no el pot baixar.
«Aquest vídeo no està disponible.»	La persona autora l'ha esborrat, o no es pot veure al teu país.	Obre l'enllaç al navegador per veure si funciona.
«El vídeo requereix iniciar sessió o té restriccions d'edat. Aquesta versió no gestiona cookies.»	La plataforma demana sessió o confirmació d'edat.	El programa no el pot baixar.
«Aquest enllaç no és compatible amb yt-dlp.»	La web no és una que yt-dlp sàpiga llegir.	Actualitza yt-dlp. Si segueix igual, no es pot baixar.
«Falta ffmpeg. Instal·la'l amb: sudo apt-get install ffmpeg»	Falta un paquet del sistema.	Executa l'ordre amb la contrasenya d'administrador.
«Problema de connexió.» (seguit d'un consell per revisar la xarxa)	No s'ha pogut connectar amb la web.	Revisa la connexió i torna a intentar-ho.
«yt-dlp pot estar desactualitzat per a aquesta plataforma.» (seguit d'un consell per actualitzar-lo)	yt-dlp no entén la web tal com és ara.	Actualitza yt-dlp (vegeu «Actualitzacions»).
«Pot ser que yt-dlp estigui desactualitzat. Vols actualitzar-lo ara?»	Diàleg que apareix quan l'error pot ser de versió.	Si dius que sí, el programa actualitza yt-dlp.
«Falta l'entorn de yt-dlp. Obre un terminal i executa: av-dwnldr actualitzar»	Falta el pas 3 de la instal·lació. Des del menú apareix com a notificació.	Executa l'ordre (vegeu «Instal·lació», pas 3).
«Espera que acabi l'operació en curs.»	Has volgut actualitzar yt-dlp mentre hi havia una descàrrega.	Espera que acabi, o cancel·la-la.
«No s'ha pogut completar l'operació: …»	Un error que el programa no reconeix. Després dels dos punts, la primera línia del missatge original.	Mira el «Registre» per veure'n més, o copia el text si demanes ajuda.

Preguntes freqüents

Puc baixar una llista de reproducció?

Si l'enllaç és d'una llista de reproducció, el programa només baixa el primer vídeo, i la línia sota el títol ho indica («N elements (es descarrega el primer)»). Si l'enllaç és d'un vídeo que forma part d'una llista, només es baixa aquest vídeo.

Puc baixar vídeos de qualsevol web?

No. yt-dlp admet moltes webs, però no totes. Si la web no és compatible, el programa ho diu. Les webs canvien sovint: si una descàrrega falla, el primer pas és actualitzar yt-dlp (vegeu «Actualitzacions»).

Per què no baixa un vídeo privat o amb restriccions d'edat?

El programa no fa servir cookies ni la teva sessió. Per això no pot accedir a contingut que demana iniciar sessió o confirmar l'edat, i ho indica amb el missatge «El vídeo requereix iniciar sessió…».

Funciona a Windows o a macOS?

No. Està pensat per a Debian i Ubuntu, i s'instal·la amb apt.

Com el desinstal·lo?

Executa sudo apt remove av-dwnldr. Això esborra el programa, però no els teus vídeos ni els ajustos. Si també vols esborrar yt-dlp i els ajustos, són aquests:

• la carpeta ~/.local/share/yt-dlp-venv;
• el fitxer ~/.local/bin/yt-dlp;
• la carpeta ~/.config/av-dwnldr.

Més informació

• El programa és lliure, amb llicència GPL-3.0. yt-dlp està sota The Unlicense.
• Repositori: git.terata.org/terata/av-dwnldr
• Canvis de cada versió: CHANGELOG