-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.md
229 lines (151 loc) · 15.4 KB
/
README.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
# **Medio - YouTube Converter**
**Medio** is a user-friendly software for downloading YouTube content. Whether you're looking to save videos, extract audio or download entire playlists, Medio provides an all-in-one tool to meet your needs. Its simple, intuitive interface lets you quickly input a YouTube link, choose your desired quality and filename, and start the download with just a few clicks.
### **Key Features**
- **Video Downloads:** Download YouTube videos in a variety of formats and qualities, so you can enjoy your favorite content offline whenever you need it.
- **Audio Extraction:** If you only need the audio, Medio makes it easy to extract and download the audio from any YouTube video.
- **Playlist Downloads:** With Medio, you can download entire playlists at once, saving you time and effort. This is especially helpful for users who want to bulk-download videos for offline viewing.
### **Supported Formats**
Medio supports a wide range of video and audio formats:
- **Video Formats:** `MP4`, `MKV`, `AVI`, `FLV`, `WMV`, `MOV`
- **Audio Formats:** `MP3`, `OGG`, `WAV`, `M4A`, `AAC`, `WMA`
### **Quality Control**
Medio gives you the flexibility to choose from a wide range of video and audio qualities:
- **Video Quality Options:** `4320p`, `2160p`, `1440p`, `1080p`, `720p`, `480p`, `360p`, `240p`, `144p`
- **Audio Quality Options:** `160k`, `128k`, `96k`, `64k`, `48k`, `32k`
Medio uses the ffmpeg library to recode the audio, ensuring that the final media file matches the user's selected audio quality, even down to `32 kbps` if needed. If the selected audio or video quality isn’t available on YouTube, Medio **automatically** selects the **highest available** quality for the one that isn’t supported, ensuring the best possible result. While Medio can technically support higher audio qualities, YouTube currently caps audio at `160 kbps`, so re-encoding beyond this limit would only increase file size without improving sound quality.
## **Table of Contents**
1. [System Requirements](#system-requirements)
2. [License Options and Benefits](#license-options-and-benefits)
- [Premium License](#license-options-and-benefits)
3. [Free Trial License Key](#free-trial-license-key)
4. [Getting Started Guide](#getting-started-guide)
- [Step 1: Configure Your Settings](#step-1-configure-your-settings)
- [Step 2: Download Your Content](#step-2-download-your-content)
5. [Updating Software](#updating-software)
6. [Third-Party Libraries](#third-party-libraries)
- [FFmpeg](#ffmpeg)
- [yt-dlp](#yt-dlp)
7. [Data Collection and Account Management](#data-collection-and-account-management)
- [Key Activation and Data Sync](#key-activation-and-data-sync)
8. [Copyright](#copyright)
9. [Screenshots](#screenshots)
## **System Requirements**
### **Minimum Requirements**
- **Operating System:** Windows 7 or higher
- **Processor:** Dual-core processor (e.g., Intel Core 2 Duo or AMD Athlon X2)
- **RAM:** 2 GB
- **Storage:** 200 MB of free disk space
- **Software:** .NET 6.0 Runtime
- [Download .NET 6.0 Runtime](https://dotnet.microsoft.com/download/dotnet/6.0/runtime)
- **Internet:** Internet connection for downloading content and verifying licenses
### **Recommended Requirements**
- **Operating System:** Windows 7 or higher
- **Processor:** Quad-core processor (e.g., Intel Core i5 or AMD Ryzen 5)
- **RAM:** 4 GB or higher
- **Storage:** 200 MB of free disk space
- **Software:** .NET 6.0 Runtime
- [Download .NET 6.0 Runtime](https://dotnet.microsoft.com/download/dotnet/6.0/runtime)
- **Internet:** A stable internet connection for optimal performance
## **License Options and Benefits**
Medio is available for **free**, allowing users to download unlimited video and audio files in various formats. By purchasing a Premium License, you can unlock a range of additional features that provide lifetime access, available anytime and from anywhere. Once activated, these features remain permanent unless the software is reinstalled in a new directory or on a different device. In those cases, the license key will need to be redeemed again to restore data from the database. After payment is processed successfully, the Premium License will be automatically sent to your email within **5-10 minutes**.
### **★--[ Premium License ]--★**
| **Feature** | **Description** |
|---------------------------------|------------------------------------------------------------------------|
| **Unlimited Bandwidth** | Download media files at high speeds without any bandwidth restrictions |
| **Extended History** | Access a larger download history, expanded from 10 entries to 100 |
| **Secure Storage** | Securely retrieve account data from the database using your license key|
| **Additional Resolutions** | Choose from higher video resolutions, including 2160p and 4320p |
| **Playlist Downloader** | Download and convert multiple media files using the Playlist Downloader |
## **Free Trial License Key**
Experience Medio's Premium features with the free trial license key provided below. This key grants a one-time access to Premium features, including unlimited bandwidth, playlist downloads, expanded history and higher video resolutions, available for up to **10** downloads.
**Unlock Medio's Premium Features:**
```yaml
License Key: PT4O-5TYD-WKTV-0ZZ7
```
Once the license key has been redeemed, it becomes invalid and can't be used again. After the download limit is reached, the Premium features will no longer be accessible.
## **Getting Started Guide**
Follow these steps to begin downloading from YouTube:
### **Step 1: Configure Your Settings**
1. **Open the Settings Menu**
- Launch **Medio** and navigate to the `Settings` tab.
2. **Set Your Preferences**
- **Format:** Choose the desired video or audio format for your downloads.
- **Additional Settings:** Adjust settings like buffer size to suit your needs.
### **Step 2: Download Your Content**
1. **Access the Converter**
- Go to the **Converter** tab in the sidebar.
2. **Select Download Type**
- Choose whether to download the **video** or extract only the **audio** from a YouTube link.
3. **Enter the YouTube URL**
- Paste the YouTube link into the input field at the top of the **Converter** page.
4. **Configure Download Options**
- **Save Location:**
- Click the `...` button next to the directory path field to select your save location.
- For playlists, it’s recommended to create a dedicated folder to keep files organized.
- **File Name:**
- Enter a custom name in the `Title your Video` field.
- For playlists, original video titles are used automatically.
- **Select Quality:**
- Choose your preferred resolution from the available options. If quality isn't your top priority, opting for a lower quality can help reduce the file size.
5. **Initiate the Download**
- Click the `Start Download` button to begin the process.
- **Monitor Progress:** Check the progress in the upper-right corner of the app. The `Loading Tools` status means **Medio** is preparing your download, which usually takes a few seconds.
**Medio** only processes valid YouTube links. If an unrecognized URL is entered, the software will display an Invalid Link status. Additionally, if a media file with the same name and format already exists in the specified download path, it will be **automatically skipped** during the download process. If the status changes to Network Error, this means the download was interrupted due to a lost Internet connection. To ensure successful downloads, especially when downloading complete playlists, make sure your Internet connection is stable.
For further assistance or detailed information, do not hesitate to open an [issue](https://github.com/BerndHagen/Medio-YouTube-Converter/issues). For any questions or to start a discussion, feel free to initiate a [discussion](https://github.com/BerndHagen/Medio-YouTube-Converter/discussions) on the GitHub repository.
## **Updating Software**
To ensure Medio continues to perform at its best, it's important to keep it updated. Updates not only introduce new features but also fix bugs that could cause issues, such as incomplete downloads or errors during conversion. Running an outdated version may lead to problems due to outdated files. You can check your current version by locating the Build Number in the bottom left corner of the application, which helps you determine if a newer version is available on the GitHub repository.
To update Medio follow these steps:
1. Download the latest version from the repository and save it to your device.
2. Open the downloaded **ZIP** file and start the setup to begin the installation.
3. Follow the instructions to replace old files with the new updates.
4. Once the installation is complete, launch the application.
Furthermore, make sure the installation path is set to `C:\Users\...\AppData\Local\Arctisoft-Studio\Medio - YouTube Converter`. This prevents any issues and ensures that features aren’t blocked due to lack of administrative rights.
## Third-Party Libraries
Medio leverages several third-party libraries to efficiently process media files and deliver a seamless user experience. The two primary libraries are **FFmpeg** and **yt-dlp**.
### FFmpeg
**FFmpeg** is a robust multimedia framework essential to Medio’s functionality. It handles video, audio and other multimedia files and streams, enabling tasks such as format conversion and media encoding/decoding.
- **Website:** [FFmpeg Official Website](https://ffmpeg.org)
- **License:** FFmpeg is licensed under the LGPL or GPL, depending on the configuration and features used.
### yt-dlp
**yt-dlp** is an open-source command-line tool that enables the downloading of videos from YouTube. Medio integrates yt-dlp to efficiently manage content extraction and downloads, ensuring users can easily access a wide range of sources. This library is regularly updated to stay compatible with the latest website changes and formats.
- **Website:** [yt-dlp GitHub Repository](https://github.com/yt-dlp/yt-dlp)
- **License:** yt-dlp is licensed under the Unlicense, a public domain equivalent license, allowing free use, distribution, and modification.
### Additional Information
For more details about FFmpeg and yt-dlp, including their capabilities and licensing, refer to their official documentation:
- **FFmpeg Documentation:** [FFmpeg Documentation](https://ffmpeg.org/documentation.html)
- **yt-dlp Documentation:** [yt-dlp Documentation](https://github.com/yt-dlp/yt-dlp#readme)
If you have any questions or issues related to these libraries, please [open an issue](https://github.com/BerndHagen/Medio-YouTube-Converter/issues) on GitHub.
## Data Collection and Account Management
Medio collects account data to improve and personalize your experience. When you install and launch the application for the first time, an account is automatically created in the database, enabling you to start using Medio immediately. The data collected includes:
- Personal settings
- Selected avatar
- Account creation date
- Accumulated experience points and current level
- Total megabytes downloaded
- Total number of audio and video files downloaded
- Number of remaining downloads when using a trial license key
- Version of Medio being used (e.g., Basic or Premium)
### Key Activation and Data Sync
Once a key is purchased and redeemed in the Settings tab under **Key Activation**, it can always be used to retrieve the latest account data from Medio's database. This ensures your preferences and progress are preserved across sessions.
While most account data is backed up and can be restored from the database, certain data, like your **Download History**, is stored locally on your device. **Locally stored data cannot be recovered** if Medio is reinstalled on a different system, which would result in the loss of your Download History.
- Accounts **without a license key** will be automatically deleted from the database after **180 days** of inactivity.
- Users with a **Premium License** linked to their account are **exempt from this time limit** and can maintain their account indefinitely.
**Note:** Once an account is deleted from the system, it **cannot be restored**. All associated data is permanently removed and cannot be recovered.
## **Copyright**
This software is the intellectual property of the Author and is protected by international copyright laws. This copyright notice outlines the key terms governing the use, distribution, and modification of the software:
1. **License**: You are granted a revocable, non-exclusive, non-transferable license to download, install, and use the software for personal, non-commercial purposes.
2. **Modifications Prohibited**: Any modification, decompiling, reverse-engineering, or derivative work based on the software is strictly prohibited without the Author's prior written consent.
3. **Attribution**: When redistributing Medio - YouTube Converter, appropriate credit to the Author is required, including a link to the original source when applicable.
4. **Third-Party Libraries**: Medio leverages third-party libraries like FFmpeg (LGPL) and yt-dlp (Unlicense) for multimedia processing. Please review and comply with their respective licenses.
5. **Warranty Disclaimer**: Medio is provided *"as is,"* without warranties of any kind, express or implied. The Author assumes no liability for damages resulting from the use of the software.
6. **Limitation of Liability**: The Author is not responsible for any indirect, special, incidental, or consequential damages arising out of the use or inability to use the software.
7. **Termination**: The license to use this software may be terminated if the terms of this notice are violated. Upon termination, all use must cease and copies must be deleted.
By using Medio - YouTube Converter, you agree to these terms and conditions. Failure to comply may result in legal action and revocation of your rights to use the software. For full details on licensing terms and further information, please refer to the [LICENSE](https://github.com/BerndHagen/Medio-YouTube-Converter/blob/main/LICENSE) file.
## **Screenshots**
If you'd like a preview of Medio before downloading, the screenshots below offer a clear overview of the application's features. Please note that future updates may introduce additional functionalities.
| Medio - Dashboard Page | Medio - Converter Page | Medio - History Page |
|------------------------------|-----------------------------|-----------------------------|
| <img src="https://github.com/BerndHagen/Medio-YouTube-Converter/raw/main/img/img_v1.5.1-medio_dashboard.png" width="300px"> | <img src="https://github.com/BerndHagen/Medio-YouTube-Converter/raw/main/img/img_v1.5.1-medio_converter.png" width="300px"> | <img src="https://github.com/BerndHagen/Medio-YouTube-Converter/raw/main/img/img_v1.5.1-medio_history.png" width="300px"> |
| Medio - Premium Page | Medio - Activation Page | Medio - Settings Page |
|-----------------------------|-----------------------------|----------------------------|
| <img src="https://github.com/BerndHagen/Medio-YouTube-Converter/raw/main/img/img_v1.5.1-medio_premium.png" width="300px"> | <img src="https://github.com/BerndHagen/Medio-YouTube-Converter/raw/main/img/img_v1.5.1-medio_redeem.png" width="300px"> | <img src="https://github.com/BerndHagen/Medio-YouTube-Converter/raw/main/img/img_v1.5.1-medio_settings.png" width="300px"> |