feat: Unified Downloader + Taskbar Widget + Audio Visualizer

.github/workflows/build.yml

@@ -5,6 +5,10 @@ on:
     branches: [ master ]
   pull_request:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
 env:
   NODE_VERSION: "22.x"
 

.gitignore

@@ -1,6 +1,7 @@
 node_modules
 /dist
 /pack
+package-lock.json
 .vscode/settings.json
 .idea
 

README.md

@@ -1,3 +1,35 @@
+# Fork Information
+
+## Purpose of This Fork
+
+This fork adds back the **adblocker plugin** and implements a new **ytdlp-based downloader plugin** that provides more reliable downloading functionality compared to the previous youtube.js implementation.
+
+### Key Changes
+- **Adblocker Plugin**: Restores ad-blocking capabilities using Cliqz adblocker
+- **Downloader (ytdlp)**: New implementation using yt-dlp for robust video/audio downloads
+
+## Keeping Your Feature Branch Updated
+
+**To keep your feature branch updated with upstream changes:**
+```bash
+git checkout master
+git fetch upstream
+git merge upstream/master
+git push origin master
+git checkout feature/adblocker-and-downloader-plugins
+git rebase master  # Cleanly applies your changes on top of latest master
+git push --force-with-lease origin feature/adblocker-and-downloader-plugins
+```
+
+**When ready to create a PR to upstream:**
+1. Make sure your feature branch is rebased on latest upstream/master (steps above)
+2. Push to your fork: `git push origin feature/adblocker-and-downloader-plugins`
+3. Go to https://github.com/pear-devs/pear-desktop and create a PR from your fork's branch
+
+Using `rebase` keeps a clean, linear history which is preferred for PRs.
+
+---
+
 <div align="center" markdown="1">
    <sup>Special thanks to:</sup>
    <br>

package.json

@@ -89,6 +89,7 @@
     "bgutils-js": "3.2.0",
     "butterchurn": "3.0.0-beta.5",
     "butterchurn-presets": "3.0.0-beta.4",
+    "chalk": "^5.6.2",
     "chinese-conv": "^4.0.0",
     "color": "5.0.3",
     "conf": "15.1.0",
@@ -145,6 +146,7 @@
     "@playwright/test": "1.58.2",
     "@stylistic/eslint-plugin": "5.7.1",
     "@total-typescript/ts-reset": "0.6.1",
+    "@types/chalk": "^2.2.4",
     "@types/electron-localshortcut": "3.1.3",
     "@types/howler": "2.2.12",
     "@types/html-to-text": "9.0.4",
@@ -185,4 +187,4 @@
     "unreleased": true,
     "output": "changelog.md"
   }
-}
+}

src/i18n/resources/ar.json

@@ -548,6 +548,10 @@
         "button": "تنزيل"
       }
     },
+    "downloader-ytdlp": {
+      "name": "أداة التنزيل (yt-dlp)",
+      "description": "يقوم بتنزيل ملفات MP3/مصدر الصوت مباشرة من الواجهة. نسخة من إضافة التنزيل تستخدم yt-dlp.exe. يمكنك تحديد مسار مخصص للملف التنفيذي وضبط سلسلة ملفات تعريف الارتباط (cookies) لتحسين نجاح التنزيلات عبر تضمين ملفات تعريف ارتباط صالحة."
+    },
     "equalizer": {
       "description": "يضيف معادل صوتي للمشغل",
       "menu": {
@@ -948,3 +952,4 @@
     }
   }
 }
+

src/i18n/resources/bg.json

@@ -548,6 +548,10 @@
         "button": "Изтегляне"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Изтегляч (yt-dlp)",
+      "description": "Изтегля MP3 / източниково аудио директно от интерфейса. Версия на приставката за изтегляне, която използва yt-dlp.exe. Можете да зададете персонализиран път до изпълнимия файл и низ с бисквитки (cookies), за да повишите успеваемостта на изтеглянията, като добавите валидни бисквитки."
+    },
     "equalizer": {
       "description": "Добавя еквалайзер към плеъра",
       "menu": {
@@ -948,3 +952,4 @@
     }
   }
 }
+

src/i18n/resources/bn.json

@@ -527,6 +527,10 @@
         "button": "ডাউনলোড"
       }
     },
+    "downloader-ytdlp": {
+      "name": "ডাউনলোডার (yt-dlp)",
+      "description": "ইন্টারফেস থেকে সরাসরি MP3 / উৎস অডিও ডাউনলোড করে. ডাউনলোডার প্লাগইনের একটি সংস্করণ যা yt-dlp.exe ব্যবহার করে। এক্সিকিউটেবলটির জন্য কাস্টম পাথ এবং বৈধ কুকি অন্তর্ভুক্ত করে ডাউনলোড সফলতার হার বাড়াতে একটি cookies string সেট করা যায়।"
+    },
     "equalizer": {
       "description": "প্লেয়ারে একটি ইকুয়ালাইজার যোগ করে",
       "menu": {
@@ -897,3 +901,4 @@
     }
   }
 }
+

src/i18n/resources/ca.json

@@ -565,6 +565,10 @@
         "button": "Descarrega"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Descàrregues (yt-dlp)",
+      "description": "Descarrega el MP3 / àudio d'origen directament des de la interfície. Una versió del connector de descàrrega que utilitza yt-dlp.exe. Pots establir un camí personalitzat per a l'executable i una cadena de cookies per millorar l'èxit de les descàrregues incloent cookies vàlides."
+    },
     "equalizer": {
       "description": "Afegeix un equalitzador al reproductor",
       "menu": {
@@ -965,3 +969,4 @@
     }
   }
 }
+

src/i18n/resources/cs.json

@@ -548,6 +548,10 @@
         "button": "Stáhnout"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Stahovač (yt-dlp)",
+      "description": "Stahuje MP3 / source audio přímo z rozhraní. Verze pluginu stahování, která používá yt-dlp.exe. Můžete nastavit vlastní cestu ke spustitelnému souboru a řetězec cookies pro zlepšení úspěšnosti stahování zahrnutím platných cookies."
+    },
     "equalizer": {
       "description": "Přidá do přehrávače ekvalizér",
       "menu": {
@@ -948,3 +952,4 @@
     }
   }
 }
+

src/i18n/resources/de.json

@@ -577,6 +577,10 @@
         "button": "Herunterladen"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Downloader (yt-dlp)",
+      "description": "Lädt MP3-/Original-Audio direkt von der Schnittstelle herunter. Eine Version des Downloader-Plugins, die yt-dlp.exe verwendet. Du kannst einen benutzerdefinierten Pfad zur ausführbaren Datei sowie einen Cookies-String festlegen, um erfolgreiche Downloads durch gültige Cookies zu verbessern."
+    },
     "equalizer": {
       "description": "Fügt einen Equalizer zum Player hinzu",
       "menu": {
@@ -995,3 +999,4 @@
     }
   }
 }
+

src/i18n/resources/el.json

@@ -527,6 +527,10 @@
         "button": "Λήψη"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Κατεβαστής (yt-dlp)",
+      "description": "Λήψεις MP3 / ήχου πηγής απευθείας από τη διεπαφή. Μια έκδοση του πρόσθετου λήψης που χρησιμοποιεί το yt-dlp.exe. Μπορείς να ορίσεις προσαρμοσμένη διαδρομή για το εκτελέσιμο και μια συμβολοσειρά cookies για να βελτιώσεις την επιτυχία των λήψεων συμπεριλαμβάνοντας έγκυρα cookies."
+    },
     "equalizer": {
       "description": "Προσθέτει έναν ισοσταθμιστή στο πρόγραμμα αναπαραγωγής",
       "menu": {
@@ -897,3 +901,4 @@
     }
   }
 }
+

src/i18n/resources/en.json

@@ -567,7 +567,11 @@
         },
         "download-playlist": "Download playlist",
         "presets": "Presets",
-        "skip-existing": "Skip existing files"
+        "skip-existing": "Skip existing files",
+        "yt-dlp-location-nice": "yt-dlp executable location",
+        "yt-dlp-location-title": "Set yt-dlp path",
+        "yt-dlp-location-label": "Path to yt-dlp executable",
+        "yt-dlp-location-saved": "yt-dlp path saved"
       },
       "name": "Downloader",
       "renderer": {
@@ -577,6 +581,10 @@
         "button": "Download"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Downloader (yt-dlp)",
+      "description": "Downloads MP3 / source audio directly from the interface. A version of the downloader plugin that uses yt-dlp.exe. You can set a custom path for the executable and a cookies string to improve successful downloads by including valid cookies."
+    },
     "equalizer": {
       "description": "Adds an equalizer to the player",
       "menu": {
@@ -926,6 +934,38 @@
       "description": "Control playback from your Windows taskbar",
       "name": "Taskbar Media Control"
     },
+    "taskbar-widget": {
+      "description": "Embeds a mini player into the Windows taskbar with album art, song info, and playback controls",
+      "name": "Taskbar Widget",
+      "menu": {
+        "monitor": {
+          "label": "Display Monitor",
+          "primary": "Primary"
+        },
+        "position": {
+          "label": "Position Offset",
+          "horizontal-offset": "Horizontal offset (px)",
+          "vertical-offset": "Vertical offset (px)"
+        },
+        "background-blur": "Background Blur",
+        "blur-opacity": "Blur Opacity (0.1–1.0)",
+        "visualizer": {
+          "label": "Taskbar Visualizer",
+          "enabled": "Enable Taskbar Visualizer",
+          "position": {
+            "label": "Visualizer Position",
+            "left": "Left of Widget",
+            "right": "Right of Widget"
+          },
+          "width": "Visualizer Width (40–300 px)",
+          "bar-count": "Bar Count (4–64)",
+          "centered-bars": "Centered Bars",
+          "show-baseline": "Show Baseline",
+          "audio-sensitivity": "Audio Sensitivity (0.01–1.0)",
+          "audio-peak-threshold": "Audio Peak Threshold (0.1–1.0)"
+        }
+      }
+    },
     "touchbar": {
       "description": "Adds a TouchBar widget for macOS users",
       "name": "TouchBar"
@@ -994,4 +1034,4 @@
       "name": "Visualizer"
     }
   }
-}
+}

src/i18n/resources/es.json

@@ -577,6 +577,10 @@
         "button": "Descargar"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Gestor de descargas (yt-dlp)",
+      "description": "Descarga audio MP3 / fuente directamente desde la interfaz. Una versión del complemento de descargas que usa yt-dlp.exe. Puedes establecer una ruta personalizada para el ejecutable y una cadena de cookies para mejorar el éxito de las descargas incluyendo cookies válidas."
+    },
     "equalizer": {
       "description": "Añade un ecualizador al reproductor",
       "menu": {
@@ -995,3 +999,4 @@
     }
   }
 }
+

src/i18n/resources/fa.json

@@ -564,6 +564,10 @@
         "button": "دانلود"
       }
     },
+    "downloader-ytdlp": {
+      "name": "دانلودر (yt-dlp)",
+      "description": "دانلود MP3 / صدای منبع به طور مستقیم از رابط. نسخه‌ای از افزونهٔ دانلود که از yt-dlp.exe استفاده می‌کند. می‌توانید مسیر سفارشی برای فایل اجرایی و یک رشتهٔ کوکی‌ها تنظیم کنید تا با افزودن کوکی‌های معتبر، موفقیت دانلودها بیشتر شود."
+    },
     "equalizer": {
       "description": "اضافه کردن یک اکولایزر به پخش‌کننده",
       "menu": {
@@ -964,3 +968,4 @@
     }
   }
 }
+

src/i18n/resources/fi.json

@@ -527,6 +527,10 @@
         "button": "Lataa"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Lataaja (yt-dlp)",
+      "description": "Lataa MP3- tai lähdetiedoston suoraan käyttöliittymästä. Latauslisäosan versio, joka käyttää yt-dlp.exe:tä. Voit asettaa suoritettavalle tiedostolle mukautetun polun sekä eväste-merkkijonon parantaaksesi latausten onnistumista lisäämällä kelvolliset evästeet."
+    },
     "equalizer": {
       "description": "Lisää taajuuskorjaimen toistimeen",
       "menu": {
@@ -777,3 +781,4 @@
     }
   }
 }
+

src/i18n/resources/fil.json

@@ -536,6 +536,10 @@
         "button": "I-download"
       }
     },
+    "downloader-ytdlp": {
+      "name": "Taga-download (yt-dlp)",
+      "description": "Dina-download ang mga MP3 / source audio direkta mula sa interface. Isang bersyon ng plugin na pang-download na gumagamit ng yt-dlp.exe. Maaari kang magtakda ng custom na path para sa executable at isang cookies string para mas tumaas ang tagumpay ng pag-download sa pamamagitan ng paglalagay ng valid na cookies."
+    },
     "equalizer": {
       "description": "Nagdaragdag ng equalizer sa player",
       "menu": {
@@ -910,3 +914,4 @@
     }
   }
 }
+