ytdl-android/README.md

<h1 align="center">
	<img src="app/src/main/ic_launcher-playstore.png" width="15%" /> <br>
	YTDLnis
</h1>

<h3 align="center">
	YTDLnis is a free and open source video/audio downloader using yt-dlp for Android 6.0 and above.
</h3>

<div align="center">

![CI](https://github.com/deniscerri/ytdlnis/actions/workflows/android.yml/badge.svg?branch=main&event=pull) 
[![stable release](https://img.shields.io/github/release/deniscerri/ytdlnis.svg?maxAge=3600&label=download)](https://github.com/deniscerri/ytdlnis/releases/latest) 
[![preview release](https://img.shields.io/github/release/deniscerri/ytdlnis.svg?maxAge=3600&include_prereleases&label=preview)](https://github.com/deniscerri/ytdlnis/releases) 
[![downloads](https://img.shields.io/github/downloads/deniscerri/ytdlnis/total?style=flat-square)](https://github.com/deniscerri/ytdlnis/releases) 
[![Translation status](https://hosted.weblate.org/widgets/ytdlnis/-/svg-badge.svg)](https://hosted.weblate.org/engage/ytdlnis/?utm_source=widget) 
[![community](https://img.shields.io/badge/Discord-YTDLnis-blueviolet?style=flat-square&logo=discord)](https://discord.gg/WW3KYWxAPm) 
[![community](https://img.shields.io/badge/Telegram-YTDLnis-blue?style=flat-square&logo=telegram)](https://t.me/ytdlnis)




</div>

## Features:

- download audio/video files from more than <a href="https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md">1000 websites</a>
- download playlists or multi select items
- queue downloads and schedule them by date and time
- use custom commands and templates or go full terminal mode
- remove sponsorblock chapters
- embed subtitles/metadata/chapters etc
- modify metadata such as title and author
- split item into separate files depending on its chapters
- select different download formats
- process multiple items before download
- quick share card right from the share menu 
- search or insert a link from the app
- log downloads
- re-download cancelled or failed downloads
- incognito mode when you don't want to save a download history
- download multiple items at the same time
- change preferred audio/video formats and qualities
- Material You interface
- MVVM Architecture w/ WorkManager
- easy to use :)

## Screenshots

<div>
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/5.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/6.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/7.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/8.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/9.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/10.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/11.png" width="30%" />
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/12.png" width="30%" />
</div>

## Connect with YouTube Revanced

The App's package name is com.deniscerri.ytdl

## Help Translate on Weblate

<a href="https://hosted.weblate.org/engage/ytdlnis/">
<img src="https://hosted.weblate.org/widgets/ytdlnis/-/multi-auto.svg" alt="Translation status" />
</a>

## License

[GNU GPL v3.0](https://github.com/deniscerri/ytdlnis/blob/main/LICENSE)

Warning <br>
Except for the source code licensed under the GPLv3 license, all other parties are prohibited from using the 'YTDLnis' name as a downloader app, and the same is true for its derivatives. Derivatives include but are not limited to forks and unofficial builds.

## Thanks

- [yt-dlp](https://github.com/yt-dlp/yt-dlp) and its contributors for making this tool possible. Without it this app wouldn't exist.
- [youtubedl-android](https://github.com/yausername/youtubedl-android) for porting yt-dlp to android
- [dvd](https://github.com/yausername/dvd) for showing how to implement youtubedl-android
- [seal](https://github.com/JunkFood02/Seal) for certain design elements and features i wanted to use aswell in this app
- [decipher3114](https://github.com/decipher3114) for the app icon

and alot of other internet forum strangers.