PHP CSS Smarty JavaScript Other
Clone or download
Failed to load latest commit information.
classes feat: Add STREAM environment variable so stream mode can be enabled o… Jul 6, 2018
config fix: Run youtube-dl with --no-playlist May 23, 2018
controllers fix: Check if the url GET parameter is empty Aug 13, 2018
css feat: Add a way to trim the audio Jul 3, 2018
i18n Update Alltube.po ( Jul 3, 2018
img Remove Google Cast support since the JS library does not seem to be m… Jul 3, 2017
resources docs(FAQ): Explain why is slow Aug 13, 2018
templates chore: Missing translations Jul 3, 2018
templates_c Add templates_c to repo Jun 28, 2015
tests style: Lint May 26, 2018
.appveyor.yml ci(appveyor): Install phantomjs on AppVeyor Jan 25, 2018
.dockerignore Docker build Dec 4, 2015
.gitignore Generate .mo files with Grunt May 29, 2017
.htaccess Hotfix: Tweak X-Frame-Options header so we can include Heroku error p… Oct 28, 2017
.travis.yml style: Cleanup .travis.yml Apr 9, 2018 Create Jul 30, 2017 docs: Be more consistent and use "AllTube" everywhere Mar 19, 2018
Dockerfile Fix missing gnupg program Jul 26, 2018
Gruntfile.js build(grunt): Don't include phantomjs in release package Jan 26, 2018 docs: Be more consistent and use "AllTube" everywhere Mar 19, 2018
LICENSE Create LICENSE Jan 7, 2015
Procfile Use Apache on Heroku Jun 4, 2015 docs: Add Liberapay link to README May 26, 2018
app.json fix: STREAM is not required on Heroku Jul 6, 2018
composer.json build(composer): Update youtube-dl to 2018.06.02 Jun 3, 2018
composer.lock build(composer): Update youtube-dl to 2018.06.02 Jun 3, 2018
index.php feat: Allow Youtube-like URLs Aug 4, 2018
package.json build(yarn): 1.2.0 release Aug 13, 2018
phpdoc.xml style: Lint XML Jun 3, 2018
phpunit.xml style: Lint XML Jun 3, 2018
requirements.txt Use Python buildpack in order to have a recent Python version Dec 22, 2016
robots.txt fix: Use HTTPS in robots.txt Jun 3, 2018
yarn.lock build(yarn): Dependencies update Jun 4, 2018

AllTube Download

Donate using Liberapay

HTML GUI for youtube-dl (



From a release package

You can download the latest release package here.

You just have to unzip it on your server and it should be ready to use.

From Git

In order to get AllTube working, you need to use Yarn and Composer:

yarn install
composer install

This will download all the required dependencies.

(Note that it will download the ffmpeg binary for 64-bits Linux. If you are on another platform, you might want to specify the path to avconv/ffmpeg in your config file.)

You should also ensure that the templates_c folder has the right permissions:

chmod 770 templates_c/

(You need to adapt this to your permission model. You can find more information about this in the Smarty documentation.)

If your web server is Apache, you need to set the AllowOverride setting to All or FileInfo.


When updating from Git, you need to run yarn and Composer again:

git pull
yarn install --prod
composer install

On Heroku



If you want to use a custom config, you need to create a config file:

cp config/config.example.yml config/config.yml

PHP requirements

You will need PHP 5.5 (or higher) and the following PHP modules:

  • fileinfo
  • intl
  • mbstring
  • curl

Web server configuration


You will need the following modules:

  • mod_mime
  • mod_rewrite


Here is an exemple Nginx configuration:

server {
        server_name localhost;
        listen 443 ssl;

        root /var/www/path/to/alltube;
        index index.php;

        access_log  /var/log/nginx/alltube.access.log;
        error_log   /var/log/nginx/alltube.error.log;

        types {
                text/html   html htm shtml;
                text/css    css;
                text/xml    xml;
                application/x-web-app-manifest+json   webapp;

        # Deny access to dotfiles
        location ~ /\. {
                deny all;

        location / {
                try_files $uri /index.php?$args;

        location ~ \.php$ {
                try_files $uri /index.php?$args;

                fastcgi_param     PATH_INFO $fastcgi_path_info;
                fastcgi_param     PATH_TRANSLATED $document_root$fastcgi_path_info;
                fastcgi_param     SCRIPT_FILENAME $document_root$fastcgi_script_name;

                fastcgi_pass unix:/var/run/php5-fpm.sock;
                fastcgi_index index.php;
                fastcgi_split_path_info ^(.+\.php)(/.+)$;
                fastcgi_intercept_errors off;

                fastcgi_buffer_size 16k;
                fastcgi_buffers 4 16k;

                include fastcgi_params;

Other dependencies

You need avconv in order to enable conversions. If you don't want to enable conversions, you can disable it in config.yml.

On Debian-based systems:

sudo apt-get install libav-tools

You also probably need to edit the avconv variable in config.yml so that it points to your ffmpeg/avconv binary (/usr/bin/avconv on Debian/Ubuntu).

Use as library

AllTube can also be used as a library to extract a video URL from a webpage.

You can install it with:

composer require rudloff/alltube

You can then use it in your PHP code:

use Alltube\Config;
use Alltube\VideoDownload;

require_once __DIR__.'/vendor/autoload.php';

$downloader = new VideoDownload(
    new Config(
            'youtubedl' => '/usr/local/bin/youtube-dl',


The library documentation is available on

You can also have a look at this example project.


We also provide a JSON API that you can use like this: /json?

It returns a JSON object generated by youtube-dl. You can find a list of all the properties in the youtube-dl documentation.


Please read the FAQ before reporting any issue.


This software is available under the GNU General Public License.

Please use a different name and logo if you run it on a public server.