# Mobilevids Downloader
<!-- TOC -->
- [Introduction](#introduction)
- [Features](#features)
- [Installation instructions](#installation-instructions)
- [Recommended installation method for all Operating Systems](#recommended-installation-method-for-all-operating-systems)
- [Filing an issue/Reporting a bug](#filing-an-issuereporting-a-bug)
- [Contact](#contact)
<!-- /TOC -->
# Introduction
[Mobilevids][1] is an amazing website for downloading movies and tv shows.
This script makes it easier to batch download movies or TV serials.
Why is this helpful? A utility like [wget][2] can work, but has the
following limitations:
1. Video names have numbers in them, but this does not correspond to
the actual order. Manually renaming them is a pain that is best left
for computers.
2. Using names from the syllabus page provides more informative names.
3. Using `wget` in a for loop picks up extra videos which are not
posted/linked, and these are sometimes duplicates.
This work was originally inspired in part by [coursera-dl][3].
# Features
* Support for all kinds of movies / TV shows.
* Intentionally detailed names, so that it will display and sort properly
on most interfaces (e.g., [VLC][4] or MX Video on Android devices).
* Login credentials accepted on command-line or from `.netrc` file.
* Core functionality tested on Linux, Mac and Windows.
# Installation instructions
`mobilevids-dl` requires Python 3 and a free Mobilevids account.
**Note:** We *strongly* recommend that you use a Python 3 interpreter (3.9
or later).
On any operating system, ensure that the Python executable location is added
to your `PATH` environment variable and, once you have the dependencies
installed (see next section), for a *basic* usage, you will need to invoke
the script from the main directory of the project and prepend it with the
word `python`. You can also use more advanced features of the program by
looking at the "Running the script" section of this document.
## Recommended installation method for all Operating Systems
From a command line (preferably, from a virtual environment), simply issue
the command:
pip install mobilevids-dl
This will download [the latest released version][7] of the program from the
[Python Package Index (PyPI)][6] along with *all* the necessary
dependencies. At this point, you should be ready to start using it.
If this does not work, because your Python 2 version is too old (e.g. 2.7.5
on Ubuntu 14.4), try:
apt-get install python3 python3-pip
pip3 install mobilevids-dl
instead.
**Note 1:** We strongly recommend that you *don't* install the package
globally on your machine (i.e., with root/administrator privileges), as the
installed modules may conflict with other Python applications that you have
installed in your system (or they can interfere with `mobilevids-dl`). Prefer
to use the option `--user` to `pip install`, if you can.
**Note 2:** As already mentioned, we *strongly* recommend that you use a new
Python 3 interpreter (e.g., 3.9 or later), since Python 3 has better support
for SSL/TLS (for secure connections) than earlier versions.<br/>
# Running the script
Refer to `mobilevids-dl --help` for a complete, up-to-date reference on the runtime options
supported by this utility.
```bash
usage: mobilevids-dl [-h] [-a] [-d] [-i] [-e EPISODE] [-m MOVIE] [-p PASSWORD] [-s SEASON] [-t TV]
[-u USERNAME]
[search]
Mobilevids Downloader script
positional arguments:
search
optional arguments:
-h, --help show this help message and exit
-a, --ascii show ascii art
-d, --debug debugs the program - duh
-i, --info show info about movie/show
-e EPISODE, --episode EPISODE
download a single episode (must be used with -t [TV ID] and -s [SEASON]
-m MOVIE, --movie MOVIE
downloads the ID of a movie
-p PASSWORD, --password PASSWORD
provide a mobilevids password
-s SEASON, --season SEASON
specify season to download (must use with -t)
-t TV, --tv TV download a TV show based on it's ID
-u USERNAME, --username USERNAME
provide a mobilevids username
```
Run the script to download the media by providing your mobilevids account
credentials (e.g. email address and password or a `~/.netrc` file), the
movie name, as well as any additional parameters:
On \*nix platforms, the use of a `~/.netrc` file is a good alternative to
specifying both your username (i.e., your email address) and password every
time on the command line. To use it, simply add a line like the one below to
a file named `.netrc` in your home directory (or the [equivalent][5], if you
are using Windows) with contents like:
```
machine mobilevids-dl login <user> password <pass>
```
Create the file if it doesn't exist yet. From then on, you can switch from
using `-u` and `-p` to simply call `mobilevids-dl`.
This is especially convenient, as typing usernames (email
addresses) and passwords directly on the command line can get tiresome (even
more if you happened to choose a "strong" password).
# Reporting issues
Before reporting any issue please follow the steps below:
1. Verify that you are running the latest version of the script, and the
recommended versions of its dependencies, see them in the file
`requirements.txt`. Use the following command if in doubt:
pip install --upgrade mobilevids-dl
2. If the problem persists, feel free to [open an issue][issue] in our
bugtracker, please fill the issue template with *as much information as
possible*.
[issue]: https://github.com/ahron-maslin/mobilevids-dl/issues
# Filing an issue/Reporting a bug
When reporting bugs against `mobilevids-dl`, please don't forget to include
enough information so that you can help us help you:
* Is the problem happening with the latest version of the script?
* What operating system are you using?
* Do you have all the recommended versions of the modules? See them in the
file `requirements.txt`.
* What are the precise messages that you get? Please, use the `--debug`
option before posting the messages as a bug report. Please, copy and paste
them. Don't reword/paraphrase the messages.
# Contact
Please, post bugs and issues on [github][7]. Please, **DON'T** send support
requests privately to the maintainers! We are quite swamped with day-to-day
activities. If you have problems, **PLEASE**, file them on the issue tracker.
[1]: https://www.mobilevids.org
[2]: https://sourceforge.net/projects/gnuwin32/files/wget/1.11.4-1/wget-1.11.4-1-setup.exe
[3]: https://www.github.com/coursera-dl/coursera-dl
[4]: https://f-droid.org/repository/browse/?fdid=org.videolan.vlc
[5]: http://stackoverflow.com/a/6031266/962311
[6]: https://pypi.python.org/
[7]: https://pypi.python.org/pypi/mobilevids-dl
Raw data
{
"_id": null,
"home_page": "https://github.com/ahron-maslin/mobilevids-dl",
"name": "mobilevids-dl",
"maintainer": "Aharon Maslin",
"docs_url": null,
"requires_python": "",
"maintainer_email": "aronmas613@gmail.com",
"keywords": "mpbilevids-dl,mobilevids,download,entertainment,video",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/42/31/c5a22dc3fb55b13bc632614356408103c4649677da033ab61918806e7d21/mobilevids-dl-1.0.6.tar.gz",
"platform": "any",
"description": "# Mobilevids Downloader\n\n\n<!-- TOC -->\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Installation instructions](#installation-instructions)\n - [Recommended installation method for all Operating Systems](#recommended-installation-method-for-all-operating-systems)\n- [Filing an issue/Reporting a bug](#filing-an-issuereporting-a-bug)\n- [Contact](#contact)\n\n<!-- /TOC -->\n\n# Introduction\n\n[Mobilevids][1] is an amazing website for downloading movies and tv shows.\n\nThis script makes it easier to batch download movies or TV serials.\n\nWhy is this helpful? A utility like [wget][2] can work, but has the\nfollowing limitations:\n\n1. Video names have numbers in them, but this does not correspond to\n the actual order. Manually renaming them is a pain that is best left\n for computers.\n2. Using names from the syllabus page provides more informative names.\n3. Using `wget` in a for loop picks up extra videos which are not\n posted/linked, and these are sometimes duplicates.\n\nThis work was originally inspired in part by [coursera-dl][3].\n\n\n# Features\n * Support for all kinds of movies / TV shows.\n * Intentionally detailed names, so that it will display and sort properly\n on most interfaces (e.g., [VLC][4] or MX Video on Android devices).\n * Login credentials accepted on command-line or from `.netrc` file.\n * Core functionality tested on Linux, Mac and Windows.\n\n\n# Installation instructions\n\n`mobilevids-dl` requires Python 3 and a free Mobilevids account.\n\n**Note:** We *strongly* recommend that you use a Python 3 interpreter (3.9\nor later).\n\nOn any operating system, ensure that the Python executable location is added\nto your `PATH` environment variable and, once you have the dependencies\ninstalled (see next section), for a *basic* usage, you will need to invoke\nthe script from the main directory of the project and prepend it with the\nword `python`. You can also use more advanced features of the program by\nlooking at the \"Running the script\" section of this document.\n\n\n## Recommended installation method for all Operating Systems\n\nFrom a command line (preferably, from a virtual environment), simply issue\nthe command:\n\n pip install mobilevids-dl\n\n\nThis will download [the latest released version][7] of the program from the\n[Python Package Index (PyPI)][6] along with *all* the necessary\ndependencies. At this point, you should be ready to start using it.\n\nIf this does not work, because your Python 2 version is too old (e.g. 2.7.5\non Ubuntu 14.4), try:\n\n apt-get install python3 python3-pip\n pip3 install mobilevids-dl\n\ninstead.\n\n**Note 1:** We strongly recommend that you *don't* install the package\nglobally on your machine (i.e., with root/administrator privileges), as the\ninstalled modules may conflict with other Python applications that you have\ninstalled in your system (or they can interfere with `mobilevids-dl`). Prefer\nto use the option `--user` to `pip install`, if you can.\n\n**Note 2:** As already mentioned, we *strongly* recommend that you use a new\nPython 3 interpreter (e.g., 3.9 or later), since Python 3 has better support\nfor SSL/TLS (for secure connections) than earlier versions.<br/>\n\n\n# Running the script\n\nRefer to `mobilevids-dl --help` for a complete, up-to-date reference on the runtime options\nsupported by this utility.\n\n```bash\nusage: mobilevids-dl [-h] [-a] [-d] [-i] [-e EPISODE] [-m MOVIE] [-p PASSWORD] [-s SEASON] [-t TV]\n [-u USERNAME]\n [search]\n\nMobilevids Downloader script\n\npositional arguments:\n search\n\noptional arguments:\n -h, --help show this help message and exit\n -a, --ascii show ascii art\n -d, --debug debugs the program - duh\n -i, --info show info about movie/show\n -e EPISODE, --episode EPISODE\n download a single episode (must be used with -t [TV ID] and -s [SEASON]\n -m MOVIE, --movie MOVIE\n downloads the ID of a movie\n -p PASSWORD, --password PASSWORD\n provide a mobilevids password\n -s SEASON, --season SEASON\n specify season to download (must use with -t)\n -t TV, --tv TV download a TV show based on it's ID\n -u USERNAME, --username USERNAME\n provide a mobilevids username\n```\n\nRun the script to download the media by providing your mobilevids account\ncredentials (e.g. email address and password or a `~/.netrc` file), the\nmovie name, as well as any additional parameters:\n\nOn \\*nix platforms, the use of a `~/.netrc` file is a good alternative to\nspecifying both your username (i.e., your email address) and password every\ntime on the command line. To use it, simply add a line like the one below to\na file named `.netrc` in your home directory (or the [equivalent][5], if you\nare using Windows) with contents like:\n```\n machine mobilevids-dl login <user> password <pass>\n```\nCreate the file if it doesn't exist yet. From then on, you can switch from\nusing `-u` and `-p` to simply call `mobilevids-dl`.\nThis is especially convenient, as typing usernames (email\naddresses) and passwords directly on the command line can get tiresome (even\nmore if you happened to choose a \"strong\" password).\n\n# Reporting issues\n\nBefore reporting any issue please follow the steps below:\n\n1. Verify that you are running the latest version of the script, and the\nrecommended versions of its dependencies, see them in the file\n`requirements.txt`. Use the following command if in doubt:\n\n pip install --upgrade mobilevids-dl\n\n2. If the problem persists, feel free to [open an issue][issue] in our\nbugtracker, please fill the issue template with *as much information as\npossible*.\n\n[issue]: https://github.com/ahron-maslin/mobilevids-dl/issues\n\n# Filing an issue/Reporting a bug\n\nWhen reporting bugs against `mobilevids-dl`, please don't forget to include\nenough information so that you can help us help you:\n\n* Is the problem happening with the latest version of the script?\n* What operating system are you using?\n* Do you have all the recommended versions of the modules? See them in the\n file `requirements.txt`.\n* What are the precise messages that you get? Please, use the `--debug`\n option before posting the messages as a bug report. Please, copy and paste\n them. Don't reword/paraphrase the messages.\n\n# Contact\n\nPlease, post bugs and issues on [github][7]. Please, **DON'T** send support\nrequests privately to the maintainers! We are quite swamped with day-to-day\nactivities. If you have problems, **PLEASE**, file them on the issue tracker.\n\n[1]: https://www.mobilevids.org\n[2]: https://sourceforge.net/projects/gnuwin32/files/wget/1.11.4-1/wget-1.11.4-1-setup.exe\n[3]: https://www.github.com/coursera-dl/coursera-dl\n[4]: https://f-droid.org/repository/browse/?fdid=org.videolan.vlc\n[5]: http://stackoverflow.com/a/6031266/962311\n[6]: https://pypi.python.org/\n[7]: https://pypi.python.org/pypi/mobilevids-dl\n",
"bugtrack_url": null,
"license": "LGPL",
"summary": "Script for downloading Movies and Shows from mobilevids.org",
"version": "1.0.6",
"project_urls": {
"Homepage": "https://github.com/ahron-maslin/mobilevids-dl"
},
"split_keywords": [
"mpbilevids-dl",
"mobilevids",
"download",
"entertainment",
"video"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4b4cf0c2770c4c97a1cdf94b6d39a1582d05d30399f6374d398522bef382b5ce",
"md5": "3fea9e99fe2cf6cb201707434f199c7c",
"sha256": "70f7fa4934dccf82939b31898a5635863883308fc349efc0c90e944250f6048c"
},
"downloads": -1,
"filename": "mobilevids_dl-1.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3fea9e99fe2cf6cb201707434f199c7c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 15996,
"upload_time": "2024-01-11T20:31:34",
"upload_time_iso_8601": "2024-01-11T20:31:34.784731Z",
"url": "https://files.pythonhosted.org/packages/4b/4c/f0c2770c4c97a1cdf94b6d39a1582d05d30399f6374d398522bef382b5ce/mobilevids_dl-1.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4231c5a22dc3fb55b13bc632614356408103c4649677da033ab61918806e7d21",
"md5": "cfd309018e16fb2062e2a8a65b1389bb",
"sha256": "e60ea9db53b45429d67639b88128b44aa266600607b1b66987b79fac50deab0d"
},
"downloads": -1,
"filename": "mobilevids-dl-1.0.6.tar.gz",
"has_sig": false,
"md5_digest": "cfd309018e16fb2062e2a8a65b1389bb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 18889,
"upload_time": "2024-01-11T20:31:36",
"upload_time_iso_8601": "2024-01-11T20:31:36.108321Z",
"url": "https://files.pythonhosted.org/packages/42/31/c5a22dc3fb55b13bc632614356408103c4649677da033ab61918806e7d21/mobilevids-dl-1.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-11 20:31:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ahron-maslin",
"github_project": "mobilevids-dl",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "mobilevids-dl"
}