From 93bb73c8ba72f2cff1281d734b805d929b44bdf1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Oskar=20Dudzi=C5=84ski?=
 <56404247+oskvr37@users.noreply.github.com>
Date: Fri, 7 Feb 2025 15:43:16 +0100
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Update=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* monthly downloads
* download usage
* quality table
---
 README.md | 31 ++++++++++++++++++++++---------
 1 file changed, 22 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 7b9b5ef..2980e93 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,12 @@
 # Tidal Downloader
 
-TIDDL is Python CLI application that allows downloading Tidal tracks.
-
-![GitHub top language](https://img.shields.io/github/languages/top/oskvr37/tiddl?style=for-the-badge)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/tiddl?style=for-the-badge&color=%2332af64)
 ![PyPI - Version](https://img.shields.io/pypi/v/tiddl?style=for-the-badge)
 ![GitHub commits since latest release](https://img.shields.io/github/commits-since/oskvr37/tiddl/latest?style=for-the-badge)
 [<img src="https://img.shields.io/badge/gitmoji-%20😜%20😍-FFDD67.svg?style=for-the-badge" />](https://gitmoji.dev)
 
+TIDDL is Python CLI application that allows downloading Tidal tracks.
+
 It's inspired by [Tidal-Media-Downloader](https://github.com/yaronzz/Tidal-Media-Downloader) - currently not mantained project.
 This repository will contain features requests from that project and will be the enhanced version.
 
@@ -40,13 +40,16 @@ Commands:
 
 # Basic usage
 
-Login with Tidal account
+## Login with Tidal account
 
 ```bash
 tiddl auth login
 ```
 
-Download track / album / artist / playlist
+## Download resource
+
+You can download track / album / artist / playlist / (video coming soon)
+<!-- TODO: remove coming soon after adding video download -->
 
 ```bash
 tiddl url https://listen.tidal.com/track/103805726 download
@@ -58,18 +61,28 @@ tiddl url https://listen.tidal.com/playlist/84974059-76af-406a-aede-ece2b78fa372
 > [!TIP]
 > You don't have to paste full urls, track/103805726, album/103805723 etc. will also work
 
-Set download quality and output format
+## Download options
 
 ```bash
 tiddl ... download -q master -o "{artist}/{title} ({album})"
 ```
 
 This command will:
-- download with highest quality
+- download with highest quality (master)
 - save track with title and album name in artist folder
 
-> [!NOTE]
-> More about file templating [on wiki](https://github.com/oskvr37/tiddl/wiki/Template-formatting).
+### Download quality
+
+| Quality | File extension | Details |
+|:-:|:-:|:-:|
+| LOW | .m4a | 96 kbps |
+| NORMAL | .m4a | 320 kbps |
+| HIGH | .flac | 16-bit, 44.1 kHz |
+| MASTER | .flac | Up to 24-bit, 192 kHz |
+
+### Output format
+
+More about file templating [on wiki](https://github.com/oskvr37/tiddl/wiki/Template-formatting).
 
 # Development