-

PyIDM is a python open source (Internet Download Manager) with multi-connections, high speed engine, it downloads general files and videos from youtube and tons of other streaming websites .
Developed in Python, based on "pyCuRL/libcurl", "youtube_dl", and "PySimpleGUI"

---

Features:

• High download speeds "based on libcurl" - See Speed test of: aria2 vs PyIDM
• Multi-connection downloading "Multithreading"
• Automatic file segmentation.
• Resume uncompleted downloads, and Refresh expired urls.
• Support for Youtube, and a lot of stream websites "using youtube-dl to fetch info and libcurl to download data".
• download entire video playlist or selected videos.
• download fragmented video streams, and encrypted/nonencrypted HLS media streams.
• watch videos while downloading* "some videos will have no audio until finish downloading".
• download video subtitles.
• write video metadata to downloaded files.
• check for application updates.
• Scheduling downloads
• Re-using existing connection to remote server.
• Clipboard Monitor.
• Simple GUI interface with 140 themes available. "90s-looking GUI"
• proxy support (http, https, socks4, and socks5).
• user/pass authentication, referee link, use cookies, video thumbnail, subtitles, MD5 and SHA256 checksums
• user can control a lot of options:
  • select theme.
  • set proxy.
  • Speed limit.
  • Max. Concurrent downloads.
  • Max. connections per download.

---

How to install PyIDM?

You have 3 options to run PyIDM on your operating system:

1. Windows portable version:
   Latest Windows portable version available here.
   unzip, and run from PyIDM.exe, no installation required.

2. PyPi:
   python -m pip install pyidm --upgrade --no-cache

   then you can run application from Terminal by:
   python -m pyidm note pyidm name in small letters

   or just
   pyidm an exexutable "i.e. pyidm.exe on windows" will be located at "python/scripts", if it doesn't work append "python/scripts" folder to PATH.

3. run from github source code:
   PyIDM is a python app. so, it can run on any platform that can run python, To run from source, you have to have a python installed, "supported python versions is 3.6, 3.7, and 3.8", then download or clone this repository, and run PyIDM.py (it will install the other required python packages automatically if missing) if PyIDM failed to install required packages, you should install it manually, refer to "Dependencies" section below.

4. Build PyIDM yourself:

   • get the source code from github:
     git clone https://github.com/pyIDM/PyIDM.git
     

   • or get the source code from PyPi:
     navigate to https://pypi.org/project/pyIDM/#files and download a tar ball, example file name "pyIDM-2020.3.22.tar.gz", then extract it

   • open your terminal or command prompt and navigate to pyidm folder then type below command
     python setup.py install

   • run PyIDM from Terminal by typing:
     python -m pyidm or just pyidm

important note on Tkinter for mac users:

• as mentioned in "python.org" the Apple-supplied Tcl/Tk 8.5 has serious bugs that can cause application crashes. If you wish to use Tkinter, do not use the Apple-supplied Pythons. Instead, install and use a newer version of Python from python.org or a third-party distributor that supplies or links with a newer version of Tcl/Tk.
  refer to issue #113

---

Dependencies:

below are the requirements to run from source:

• Python 3.6+: tested with python 3.6 on windows, and 3.7, 3.8 on linux
• ffmpeg : for merging audio with youtube DASH videos "it will be installed automatically on windows"

Required python packages:

• pycurl: is a Python interface to libcurl / curl as our download engine,
• PySimpleGUI: a beautiful gui builder,
• youtube_dl: famous youtube downloader, limited use for meta information extraction only but videos are downloaded using pycurl
• certifi: required by 'pycurl' for validating the trustworthiness of SSL certificates,
• pyperclip: A cross-platform clipboard module for monitoring url copied to clipboard, requires "xclip or xsel to be available on linux"
• plyer: for systray area notification.

** please read notes below

PyIDM application will do its best to install missing packages automatically once you run it. or you can install required packages manually using:

pip install -r requirements.txt

or

python -m pip install --user --upgrade certifi PySimpleGUI pyperclip plyer youtube_dl pycurl pillow

---

more snapshots

view all screenshots with different themes

---

Why another download manager?:

Originally, I made this project to help myself download some youtube videos, then decided to share it thinking it might be useful for someone else, so please don't put your fire on me if you find a mistake in code or stupid approach to solve a problem, or an ugly gui design, instead try to fix it (this is the soul of open source software, it is open for everyone to participate and improve).

what is the benefit of open source, compared to closed-source/Proprietary software if both are free?
I believe that, "if the product is free, then you are the product", most free closed-source software collect data about you, some of them are toxic and plant trojans and spy-wares in your system, with open source, nothing hidden, and source code exposed to thousands of programmers, no one can play dirty games.

Need to mention that, during working on this project I found a lot of amazing open source "download managers" projects, which are more professional than this one, and this project is never made to compete with other download managers, it is just a "hopefully useful" addition.

---

note for pycurl:

for windows users: normal pip install i.e python -m pip install pycurl might fail on windows because you need to build libcurl on your system first which is a headache. your best choice if pip fail is to download exe file for pycurl from its official download link, find the file that match your windows system and python version installed on your system, last checked on 12-06-2020, found available files for almost all Python versions upto version 3.8

example: if you have python 3.6 installed on windows 32bit, you should download "pycurl-7.43.0.2.win32-py3.6.exe" file and install it, another example: if you have python 3.7 running on windows 64 bit, you should choose and download "pycurl-7.43.0.3.win-amd64-py3.7.exe" file

other download options include a wheel, zip file, or even a windows installer

for linux users: there is no issues, since most linux distros have curl preinstalled, so pycurl will link with libcurl library to get built with no issues, checked with python versions 3.6, 3.7, and 3.8 working with no problems.

note for Youtube-dl:

youtube website changes frequently, if this application failed to retrieve video/playlist data you should update youtube-dl module thru PyIDM setting tab or manually by

python -m pip install youtube_dl --upgrade

note for pyperclip:

Pyperclip is a cross-platform Python module for copy and paste clipboard functions. it is being used if you want to monitor clipboard for files urls and it will be processed automatically by the application. On Linux, this module makes use of the xclip or xsel commands, which should come with the os. Otherwise run "sudo apt-get install xclip" on Debian like or "sudo pacman -S xclip" on archlinux

---

Windows binaries:

a standalone frozen version prepared by py2exe or cx_freeze is available at: latest version
for all available build versions you can check https://github.com/pyIDM/PyIDM/releases

---

Versions change log:

ChangeLog.txt is included in source code.

---

How to contribute to this project:

1- by testing the application and opening new issue for bug reporting, feature request, or suggestions.
2- check developer guidelines.
3- fork this repo and pull request
4- improve this readme file

---

Some recent articles/reviews on this project*:

• ghacks

• softpedia

  *help edit this list

---

Feedback:

your feedback is most welcomed by filling a new issue
or email me at: info.pyidm@gmail.com

Author,
Mahmoud Elshahat,
2019-2020

---