This repository is a personal fork of
futo-org/Grayjay.Desktop. I'm not affiliated with FUTO in any way — just a heavy daily user who happens to keep a couple of small local tweaks.Grayjay is, very plainly, the application I use the most after my terminal. The team has built something genuinely useful — and they did it the hard way: open code, plugin architecture, no telemetry, no dark patterns, real respect for users. That deserves to be said out loud, and to be supported.
Honestly, just to scratch a few of my own itches without imposing them on anyone. The changes here are small quality-of-life tweaks (carousels under the player in theater mode, queue-consume on play, per-channel playback speed, hold-to-fast-forward, a
?shortcuts overlay…). Nothing groundbreaking, nothing replacing what FUTO does — just personal stuff for my own usage.Out of respect. I don't want to look like someone trying to muscle their ideas into a project they didn't build, especially when several of my changes are still settling and might evolve. I'd rather let things mature here, then propose them upstream calmly, one focused PR at a time, only when they feel ready and clearly useful to others — never as a take-it-or-leave-it batch.
If FUTO maintainers ever want to look at any of these branches, of course I'd be happy to share, refactor as they wish, or simply close PRs that don't fit the project's direction. The decision is theirs.
Mostly so my own builds across machines stay reproducible, and so anyone curious can see the diff. It is not an attempt to redistribute Grayjay, fork the community, or compete in any way. If at any point this fork ever risked confusing users about what "Grayjay" is, or pulling attention away from the official project, I'd rather make this repository private — that's a real line for me.
The official Grayjay Desktop, from the official site:
- Website: grayjay.app/desktop
- Upstream repo: github.com/futo-org/Grayjay.Desktop (mirror of the primary GitLab)
- FUTO: futo.org
If you're a FUTO maintainer reading this and any of the above feels off, please open an issue or DM me — I'll adjust gladly.
Thank you for Grayjay. Sincerely.
— guthubrx
A handful of small personal tweaks ship with this fork — nothing that changes what Grayjay is. They're simply listed at the very bottom of this page: see Fork — additional features (EN) / Fork — fonctionnalités additionnelles (FR).
Grayjay is a multi-platform media application that allows you to watch content from multiple platforms in a single application. Using an extendable plugin system developers can make new integrations with additional platforms. Plugins are cross-compatible between Android and Desktop.
FUTO is an organization dedicated to developing, both through in-house engineering and investment, technologies that frustrate centralization and industry consolidation.
For more elaborate showcase of features and downloads, check out the website. Website: https://grayjay.app/desktop/
NOTE for MacOS Users: Our Apple signing/notarization is not entirely done yet, thus you have to run the following command once to run the application.
xattr -c ./Grayjay_osx-arm64.app
or
xattr -c ./Grayjay_osx-x64.app
Here you find the recommendations found on respective applications.
Here you install new source plugins, change which sources are used, or configure your source behavior.
Here is an example of what the video player looks like, we support various views so that you can view the video how you like. By default we show a theater view that becomes smaller when reading comments, while not entirely hiding it.
 |
 |
Grayjay also supports downloads, allowing offline viewing of videos, as well as exporting them to files usable outside of Grayjay.
Grayjay Desktop has way more features than this, but for that, check out the website or download it yourself!
Below a NixOS configuration in case you like to use Grayjay on NixOS.
(pkgs.buildFHSEnv {
name = "fhs";
targetPkgs = _: with pkgs; [
libz
icu
libgbm
openssl # For updater
xorg.libX11
xorg.libXcomposite
xorg.libXdamage
xorg.libXext
xorg.libXfixes
xorg.libXrandr
xorg.libxcb
gtk3
glib
nss
nspr
dbus
atk
cups
libdrm
expat
libxkbcommon
pango
cairo
udev
alsa-lib
mesa
libGL
libsecret
];
}).env
Each feature below lives in its own dedicated pr/* branch, kept isolated and not merged into master — master simply tracks upstream Grayjay. Isolating every change lets me propose it to FUTO calmly, one focused PR at a time, only when it's ready and clearly useful to others — never as a take-it-or-leave-it batch.
In the meantime, my local build (BlueJay) just aggregates all these branches. So this page lists everything the fork adds, even though the code for each feature lives on its branch rather than on master (which is why you won't find it in the master tree).
👉 Browse the feature branches here: all branches (their names start with pr/).
This fork tracks Grayjay Desktop upstream and adds the features listed below. Everything else behaves like upstream Grayjay. Each feature is also kept as a standalone branch for potential upstream contribution.
- Highlights home page — a hero banner mixing your subscription videos with platform recommendations, plus content carousels. Switch between Highlights and the classic layout in Settings → Home.
- Smarter Continue Watching — finished videos (watched ≥ 90 %) and dismissed items are excluded from the carousel.
- Mark Continue Watching items as watched — mark as watched or remove from history straight from the Continue Watching carousel.
- Binge watch mode — start a binge for a channel from its context menu (
...); the queue refills dynamically as you watch, with a Next-Up overlay (also visible in fullscreen and window-maximized modes). - Queue consumed on play — queued items are removed as they start playing.
- Recommendations as a horizontal carousel in theater mode (toggle).
- Per-channel playback speed — a speed override remembered per channel.
- Hold to fast-forward at a configurable speed (long press), with a speed chip overlay.
- Multiple minimized players — minimize several videos at once and switch between them.
- Collapsible carousels — collapse or expand the carousel sections under the player in theater mode, via a unified toggle bar.
- Side-by-side carousels — Continue Watching and Queue shown as side-by-side carousels under the player.
- Remove from queue — a toggle in the recommendations context menu to remove an item from the queue.
- Video context menu — right-click the video surface to access the same actions as the buttons under the player, including Share, Download and Add to.
- AI-generated smart chapters — an external command you configure (an LLM running on your own machine) analyses a video's transcript and produces titled, summarized chapters, each scored by how interesting it is. Trigger it from the video context menu.
- Interest heatmap on the seekbar — every chapter is colored on a continuous cold→hot scale (green = lighter, red = highly interesting), so the video's high points stand out at a glance.
- X-Ray side panel — the video's theses/topics, a global summary and per-chapter summaries, with adjustable font size, opacity and width.
- Filter levels — a vertical "thermometer" menu to jump through only the Top, Strong, Good, Smart or All moments.
- Output language — choose the language of the generated titles/summaries in Settings → Smart Analysis.
- In-app description links — links in a video description (YouTube and other plugin-supported platforms) open the matching content inside the app, at the right timestamp when the URL carries one, instead of opening an external browser. Unsupported links still open in the browser.
- Cmd/Ctrl+click opens a new window — for videos, channels and playlists, including description links.
- Subscription menu on the video page — subscribe/unsubscribe from the video detail view.
- Open channel minimizes the player — opening a channel from a content menu minimizes the current video instead of closing it.
- Add a channel to a subscription group from the channel context menu.
- Multi-sort with priority order — client-side sorting of results by several criteria.
- Multi-select subscription groups with batch copy/move actions.
- Local recommendations derived from your own subscriptions.
- Shortcuts overlay — press
?to display all shortcuts. - Theater toggle (
t), playback speed (</>), reload Home/Subscriptions,Escto exit window-maximized mode. - Customizable shortcuts.
Chaque fonctionnalité ci-dessous vit dans sa propre branche pr/* dédiée, isolée et non mergée dans master — master suit simplement Grayjay upstream. Isoler chaque changement me permet de le proposer à FUTO sereinement, une PR ciblée à la fois, seulement quand elle est prête et clairement utile — jamais en bloc à prendre ou à laisser.
En attendant, mon build local (BlueJay) agrège simplement toutes ces branches. Cette page liste donc tout ce que le fork ajoute, même si le code de chaque fonctionnalité vit sur sa branche plutôt que sur master (c'est pourquoi vous ne le trouverez pas dans l'arbre master).
👉 Parcourir les branches ici : toutes les branches (leurs noms commencent par pr/).
Ce fork suit Grayjay Desktop en amont et ajoute les fonctionnalités ci-dessous. Tout le reste se comporte comme Grayjay original. Chaque fonctionnalité est aussi conservée sur une branche dédiée en vue d'une éventuelle contribution upstream.
- Page d'accueil Highlights — une bannière héro mêlant les vidéos de vos abonnements et les recommandations des plateformes, plus des carrousels de contenu. Bascule entre Highlights et la disposition classique dans Paramètres → Accueil.
- Continue Watching amélioré — les vidéos terminées (vues ≥ 90 %) et les éléments masqués sont exclus du carrousel.
- Marquer les éléments Continue Watching comme vus — marquer comme vu ou retirer de l'historique directement depuis le carrousel Continue Watching.
- Mode binge watch — démarrez un binge pour une chaîne depuis son menu contextuel (
...) ; la file se réalimente dynamiquement à mesure que vous regardez, avec une superposition Next-Up (visible aussi en plein écran et en fenêtre maximisée). - File consommée à la lecture — les éléments en file sont retirés dès qu'ils commencent.
- Recommandations en carrousel horizontal en mode théâtre (activable).
- Vitesse de lecture par chaîne — une vitesse mémorisée pour chaque chaîne.
- Avance rapide maintenue à une vitesse configurable (appui long), avec une pastille de vitesse.
- Plusieurs lecteurs minimisés — minimisez plusieurs vidéos à la fois et basculez de l'une à l'autre.
- Carrousels repliables — repliez ou dépliez les sections de carrousels sous le lecteur en mode théâtre, via une barre de bascule unifiée.
- Carrousels côte à côte — Continue Watching et la file affichés en carrousels côte à côte sous le lecteur.
- Retirer de la file — une bascule dans le menu contextuel des recommandations pour retirer un élément de la file.
- Menu contextuel vidéo — clic droit sur la vidéo pour accéder aux mêmes actions que les boutons sous le lecteur, dont Partager, Télécharger et Ajouter à.
- Chapitres intelligents générés par IA — une commande externe que vous configurez (un LLM tournant sur votre propre machine) analyse la transcription d'une vidéo et produit des chapitres titrés et résumés, chacun noté selon son intérêt. Déclenchez-la depuis le menu contextuel de la vidéo.
- Carte de chaleur d'intérêt sur la barre — chaque chapitre est coloré sur une échelle continue froid→chaud (vert = léger, rouge = très intéressant), pour repérer les temps forts d'un coup d'œil.
- Panneau latéral X-Ray — les thèses/sujets de la vidéo, un résumé global et des résumés par chapitre, avec taille de police, opacité et largeur ajustables.
- Niveaux de filtre — un menu « thermomètre » vertical pour ne parcourir que les moments Top, Strong, Good, Smart ou All.
- Langue de sortie — choisissez la langue des titres/résumés générés dans Paramètres → Smart Analysis.
- Liens de description ouverts dans l'app — les liens d'une description vidéo (YouTube et autres plateformes gérées par les plugins) ouvrent le contenu correspondant dans l'application, au bon timestamp si l'URL en contient un, au lieu d'ouvrir un navigateur externe. Les liens non gérés ouvrent toujours le navigateur.
- Cmd/Ctrl+clic ouvre une nouvelle fenêtre — pour les vidéos, chaînes et playlists, y compris les liens de description.
- Menu d'abonnement sur la page vidéo — s'abonner/se désabonner depuis la vue détaillée.
- Ouvrir une chaîne minimise le lecteur — ouvrir une chaîne depuis un menu de contenu minimise la vidéo en cours au lieu de la fermer.
- Ajouter une chaîne à un groupe d'abonnements depuis le menu contextuel de la chaîne.
- Tri multiple avec ordre de priorité — tri côté client des résultats selon plusieurs critères.
- Sélection multiple de groupes d'abonnements avec actions de copie/déplacement en lot.
- Recommandations locales dérivées de vos propres abonnements.
- Aperçu des raccourcis — appuyez sur
?pour afficher tous les raccourcis. - Bascule théâtre (
t), vitesse de lecture (</>), rechargement Accueil/Abonnements,Échappour quitter le mode fenêtre maximisée. - Raccourcis personnalisables.