Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/e-alfred/ocdownloader

ocDownloader - AGPL-licensed multi-protocol download manager for Nextcloud using ARIA2, youtube-dl and Curl (supports Youtube, BitTorrent, HTTP, FTP)
https://github.com/e-alfred/ocdownloader

aria2 hacktoberfest nextcloud torrent

Last synced: 7 days ago
JSON representation

ocDownloader - AGPL-licensed multi-protocol download manager for Nextcloud using ARIA2, youtube-dl and Curl (supports Youtube, BitTorrent, HTTP, FTP)

Awesome Lists containing this project

README 

        
# ocDownloader

ocDownloader is an AGPL-licensed application for [Nextcloud](https://nextcloud.com) which allows you to download files from HTTP(S)/FTP(S)/Youtube/Bittorrent using the ARIA2 download manager/Curl and youtube-dl.



***I'm looking for maintainers and translators, every kind of support (especially pull requests) is highly welcome***.



## Companion apps/extensions for Firefox/Chrome/Opera/Vivaldi and Windows/MacOS/Linux/Android



Webextension addon for both Firefox-based and Chromium-based browsers (can be found on addons.mozilla.org and the Chrome Web Store): https://github.com/e-alfred/ocDownloader_webextension



Jetpack/PMKit addon for Firefox <=56 and Palemoon: https://github.com/e-alfred/ocDownloader_palemoon



Desktop/Mobile client for Windows/Linux/MacOS/Android: https://github.com/bbernhard/nextload-client



If you want to write your own app or extension, this would be highly welcome. ocDownloader has an API (look at controller/lib/api.php here: https://github.com/e-alfred/ocdownloader/blob/master/controller/lib/api.php) that allows you to add and list downloads using ocDownloader.



## ARIA2 installation

You have to install Aria2 on your system. To do this on Debian/Ubuntu you can use the following command:



`apt-get install aria2 curl php-curl`



After that, you have to run Aria2 on every boot with the same user that your webserver is running:



```

mkdir /var/log/aria2c /var/local/aria2c

touch /var/log/aria2c/aria2c.log

touch /var/local/aria2c/aria2c.sess

chown www-data.www-data -R /var/log/aria2c /var/local/aria2c

chmod 770 -R /var/log/aria2c /var/local/aria2c

sudo -u www-data aria2c --enable-rpc --rpc-allow-origin-all -c -D --log=/var/log/aria2c/aria2c.log --check-certificate=false --save-session=/var/local/aria2c/aria2c.sess --save-session-interval=2 --continue=true --input-file=/var/local/aria2c/aria2c.sess --rpc-save-upload-metadata=true --force-save=true --log-level=warn --rpc-secret=yoursecret

```



Please change 'yoursecret' to your own RPC secret and don't forget to change it in the ocDownloader admin settings of your Nextcloud.



You have to enable the RPC interface and save the session file of Aria2, otherwise your old downloads won't be listed after you restart Aria2. The file paths in the example can be changed if you want to store them elsewhere as long as the user running your webserver can access/write to them.



You can find the documentation of Aria2 [here](https://aria2.github.io/manual/en/html/index.html).



## Youtube-dl installation

To download Youtube videos, you have to install youtube-dl. The packages shipped with distributions are very outdated most of the time. To get around this, you can use the Python Package Installer (pip) to get the most recent youtube-dl binaries. On Debian/Ubuntu, you can use the following commands to install youtube-dl through the Python Package Installer:



```

apt-get install python-pip

pip install youtube-dl

```



For other distributions or if you don't want to use the Python Package Installer, you can [install youtube-dl manually](https://rg3.github.io/youtube-dl/download.html). *Note : You have to install Python on your server. This a requierement for youtube-dl.*  



After installing youtube-dl, you have to set the right path to your youtube-dl executeable in the admin settings of ocDownloader.



## Using Curl instead of Aria2

If you don't have Aria2 available on your server, you can use Curl which is directly integrated into PHP. This allows you to make HTTP(S) and FTP(S) downloads (BitTorrent is not supported by Curl). You need to install the PHP Curl module, on Debian you can use the following command to do this:



`apt-get install curl php-curl`



 Afterwards, you have to make sure that fallback.sh and fallback.php in the /SERVER directory of the ocDownloader app are executeable by your webserver user:



 `chmod +x SERVER/fallback.*`

 

 Enable Curl through the ocdownloader config page

 

 https://**nextcloud.url**/index.php/settings/admin/additional



If you have problems with Curl, the log files are saved to the /tmp folder on your server with these semicolon-seperated values:



- The status

- The download total size

- The current downloaded size

- The speed

- The PID of the PHP process which downloads your file (this allows to pause/restart the download while it is in progress)



## Translators

- Czech : Chazz

- Polish : Andrzej Kaczmarczyk

- Spanish / Catalan : Julián Sackmann, Erik Fargas

- German : sinus23, Moritz

- Russian : AlucoST, novikoz

- Hungarian : Károly Polacsek

- Bulgarian : Asen Gonov

- Persian : Amir Keshavarz

- Chinese : Young You, dzxx36gyy (顾益阳), whatot huang

- Italian : Leonardo Bartoletti, adelutti (Andrea), r.bicelli Riccardo Bicelli

- Danish : Janus Ljósheim, Johannes Hessellund

- Korean : Asen Gonov

- Dutch : msberends



## Authors

e-alfred  

Nibbels  

Loki3000  

(formerly) Xavier Beurois



## Releases notes

### v1.8.0 [unreleased]

- Removed Nextcloud 20 support (min version is now 21)

- Added Nextcloud 23 support

- Fixed curl download stuck in "waiting" status

- Fixed some "Trying to access array offset" errors in `queue.php`



### v1.7.1

- Added support for quota limits (thanks @Irillit)

- Moved translations to Transiflex and fixed some localization issues (thanks @MorrisJobke and @rakekniven)

- Fix deprecated API calls

- Cleanup unneeded functions

### v1.7.0

- Fixed API for extensions and apps

- Fixed setting youtube-dl path if called from API

### v1.6.3

- Fixed settings menus

- Added Magnet link support (thanks @JasonPoon-cn)

- Added support for Nextcloud 16

### v1.6.1

- Fixed deprecated API calls to support Nextcloud 14+

### v1.5.6

- Fixed deprecated API calls to support Nextcloud 13+

### v1.5.5

- Fixed CSS compatibility with Nextcloud 13 (thanks @Lokarde)

- Fixed display problems on mobile browsers

- Fixed downloads not showing up in Nextcloud using CURL (thanks @muellerlukas)

- Fixed internal server errro if PID == 0 using CURL (thanks @muellerlukas)

### v1.5.4

- Dutch translation (thanks to @msberends)

- Allow setting a custom filename after downloading for HTTP/FTP

- Truncate filenames if URL contains parameters after filename (thanks @Loki3000)

- Show tooltip if filename is too long for downloaded items table (thanks @Loki3000)

- Add fields for custom referer and user agent if using HTTP/FTP for download

### v1.5.3 (thanks @Nibbels)

- Some changes within design and site unlocks for CURL-Users

### v1.5.2 (thanks @Nibbels)

- Added some basic function which scans the downloads folder to make new downloads visible within Owncloud/Nextcloud

- hooked in the new function to the pageload of "Complete Downloads" and "All Downloads" (This is way from perfect but works somehow)

- removed 1.5.1 from commits because of license change.

### v1.5.1

- Fixing minor CSS / JS bug

### v1.5

- Update languages, add following languages : Persian, Chinese, Italian, Danish, Korean

- You can now upload a torrent file directly from the application

- The checkbox to remove a torrent file when adding a torrent download is now checked by default

- Add admin settings to manage protocols permissions

- Add a set_time_limit to 0 for the cURL fallback download script

- Add upload / download speed limit settings in the admin panel

- Add a ratio control for the BitTorrent protocol in the personal settings panel (default : unlimited - "0.0")

- Add a seed time control for the BitTorrent protocol in the personal settings panel (default : 1 week)