This project aims to provide a tool for downloading VODs from Nimo.tv. Please note that the quality of the downloaded VODs depends on the original source.
As most lay people use Windows, I only made the executable compilation available for Windows, feel free to compile it for Linux or MacOS.
If you really want to run it and encountered some problem, you can send me an email or call me on discord Capelinha#8839
First, you need to download the latest release for Windows from the releases page.
Basically, what you need to do is open a CMD window (hold Shift and press the right mouse button) in the folder where you extracted the ZIP
With Windows cmd open, use the command nimo-dl.exe [link to vod].
nimo-dl.exe https://www.nimo.tv/v/v-1793063475024888784
If you have an Nvidia graphics card, you can speed up the file merging process by using the --cuda parameter in the command.
nimo-dl.exe https://www.nimo.tv/v/v-1793063475024888784 --cuda
The video will first be downloaded and then converted from .ts to .mp4. The output files can be found in the 'output' folder.
-
Download Limitations: Occasionally, the Nimo server may restrict downloading certain parts of the video, resulting in errors. In such cases, please retry the download later.
-
Quality Limitations: Nimo.tv sometimes only provides VODs in 720p resolution, which can be frustrating. Unfortunately, there is no workaround for this limitation.
-
Watermark: Downloaded videos will retain the Nimo.tv watermark. Please be aware of this before using the tool.
This project is provided as-is and does not guarantee uninterrupted or error-free downloading of Nimo.tv VODs. Use it at your own discretion.
If you want to compile on your machine for security reasons, don't forget to download and place the ffmpeg and ffprobe files alongside the executable. Or if you are on Linux/Mac, install ffmpeg and put the path in the environment variables. (If you can use the ffmpeg command, everything is fine)
Contributions and feedback are welcome! If you encounter any issues or have suggestions for improvement, please create a GitHub issue or reach out to me directly.
The software was written in Node.js, with TypeScript support. It uses Webpack to transpile TypeScript to JavaScript and then packages the executable with PKG.
To run locally, clone the repository, install Node.js 18 (you can use another version, but at your own risk), and execute npm install in the project's root folder.
To run locally, you can use the command npm run start, and to build the executable, use npm run release. The executable will be available in the "dist" folder.
Don't forget to download and place the ffmpeg and ffprobe files alongside the executable. If you are using the npm run start command, place ffmpeg in the project root folder.
The software's operation is straightforward: it parses the input URL, consults the Nimo API to check if the VOD file already exists in MP4 format for immediate download. If not, it will download using the HLS video stream used by the site's player.
The software fetches the M3u8 file with the best video quality, parses the file, and then initiates the download of individual parts of the VOD in '.ts' format to the temp folder. It uses a queue that performs parallel download of 20 parts at a time until the M3u8 file is completed.
After the download is complete, ffmpeg is used to concatenate all .ts files in the correct order, and then the video is encoded to mp4 using the h264 encoder (libx264 or h264_nvenc). Without encoding, the video may not work properly in most common video editors.
The output files are stored in the "output" folder, and the "temp" folder is deleted after a successful completion.
Bundled FFmpeg binaries are fetched from gyan.dev © Gyan Doshi.
Note: This README is subject to updates and revisions as the project evolves.