NotchIA

Une notch macOS utile, compacte et vivante pour les medias, fichiers, outils systeme et assistants IA.

NotchIA est une app macOS native qui transforme l'encoche du MacBook en centre de controle : lecteur media, shelf de fichiers, calendrier, presse-papiers, Pomodoro, HUD systeme et suivi d'assistants IA.

L'objectif est de garder les informations utiles au bord de l'ecran, sans ajouter une fenetre flottante de plus.

Revue Des Fonctionnalites

Notch et navigation

• Notch ouverte au survol, au clic ou avec un geste.
• Fermeture automatique quand la souris quitte la zone visible.
• Onglets configurables : Media, Calendar, Shelf, Claude/IA Code, Pomodoro et Clipboard.
• Possibilite de memoriser le dernier onglet ouvert.
• Support multi-ecrans avec choix de l'ecran prefere, affichage sur tous les ecrans et bascule automatique.
• Hauteur adaptee aux ecrans avec ou sans encoche, avec mode personnalise.
• Retour haptique, ombre, rayon des coins et couleur d'accent personnalisables.

Media

• Sources disponibles : Lecture en cours macOS, Apple Music, Spotify et YouTube Music.
• Pochette, titre, artiste, barre de progression et controles de lecture.
• Slots de controles personnalisables : lecture/pause, precedent, suivant, shuffle, repeat, volume et autres actions media.
• Couleurs inspirees de la pochette, spectrogramme et effet lumineux derriere l'album.
• Paroles sous le nom de l'artiste quand l'option est activee.
• Sneak Peek lors des changements de lecture.
• Comportement configurable en plein ecran : masquer toujours, seulement pour l'app media, ou jamais.

Shelf, partage et conversion

• Zone de glisser-deposer dans la notch pour fichiers, liens, texte, images et donnees.
• Shelf persistante avec miniatures, selection, Quick Look et nettoyage des elements invalides.
• Partage rapide via le service choisi dans les reglages ou via le menu de partage systeme.
• Option pour copier les elements au drag et les retirer automatiquement apres glisser.
• Zone de detection etendue pour deposer des fichiers sur la notch fermee.
• Convertisseur integre :
  • images vers JPEG, PNG, GIF, TIFF, BMP, HEIC, WebP ou PDF ;
  • PDF vers Markdown, JPEG, PNG ou TIFF ;
  • audio vers M4A ;
  • video vers MP4, MOV, M4V ou extraction audio M4A.
• Conversion depuis un fichier depose, un fichier choisi manuellement ou plusieurs fichiers presents dans la shelf.
• Sortie enregistree dans le dossier Downloads avec nom unique.

Calendrier et rappels

• Affichage des evenements Calendrier et des rappels macOS.
• Selection des calendriers et listes de rappels a afficher.
• Masquage des rappels termines et des evenements sur toute la journee.
• Defilement automatique vers le prochain evenement.
• Option pour toujours afficher les titres complets.

IA Code

• Onglet IA Code avec selecteur de fournisseur :
  • Claude Code ;
  • ChatGPT Codex ;
  • GitHub Copilot.
• Detection des sessions locales Claude Code via ~/.claude.
• Detection des sessions Codex via ~/.codex.
• Suivi des sessions actives, outils en cours, messages recents, usage de contexte et quotas quand disponibles.
• Vue compacte dans la notch fermee avec etat de session, activite recente, permission requise, outil en cours ou tache terminee.
• Copilot affiche les infos disponibles localement : IDE, projet, phase, modele, plan, limitation eventuelle et dernier usage observe.

Presse-papiers

• Historique automatique du texte copie.
• Recherche dans l'historique.
• Groupement par application source.
• Epinglage des elements importants.
• Copie rapide en cliquant sur un element.
• Suppression individuelle, effacement de l'historique non epingle et limite configurable de 20, 48 ou 100 elements.

Pomodoro

• Minuteur Focus, pause courte et pause longue.
• Cycle long configurable apres plusieurs sessions.
• Commandes : demarrer, pause, reprendre, reinitialiser, passer la phase et repartir de zero.
• Statistiques de focus du jour.
• Sneak Peek periodique pendant les phases de focus.
• Retour audio lors des transitions.
• Vue compacte dans la notch fermee quand le minuteur tourne ou qu'une phase est en cours.

HUD systeme et indicateurs compacts

• Remplacement optionnel des HUD macOS pour volume, luminosite et retroeclairage clavier.
• HUD classique sous la notch ou HUD inline integre dans la notch fermee.
• HUD visible aussi dans la notch ouverte.
• Options de style : pourcentage, degrade, lueur et couleur d'accent.
• Detection compacte des appels actifs pour FaceTime, Zoom, Teams, Discord, Skype et Webex.
• Detection du mode Concentration / Ne pas deranger.
• Detection d'enregistrement d'ecran et option pour masquer la notch pendant l'enregistrement.
• Etat de verrouillage et deverrouillage affiche dans la notch fermee.

Webcam et apparence

• NotchIA Mirror : apercu webcam dans la notch, avec forme rectangle ou cercle.
• Animation de visage quand l'app est inactive, si activee.
• Onglets, icone de reglages, icone d'app, couleur d'accent et elements visuels configurables.
• Visualiseurs Lottie personnalises presents dans l'interface mais marques comme a venir.

Raccourcis et demarrage

• Lancement au demarrage.
• Icone dans la barre des menus configurable.
• Raccourci pour basculer Sneak Peek.
• Raccourci pour ouvrir ou fermer la notch.
• Sparkle pour la verification des mises a jour.

Etat Du Projet

NotchIA contient des fonctionnalites stables et des modules experimentaux.

Fonctionnalites principales : notch, media, shelf, partage, conversion, calendrier, presse-papiers, Pomodoro et reglages.

Fonctionnalites avancees ou beta : remplacement du HUD systeme, detection d'appel, detection du mode Focus, detection d'enregistrement d'ecran, Sneak Peek Engine, paroles, integration IA Code et certains comportements en plein ecran.

Fonctionnalites presentes mais limitees : visualiseurs musicaux personnalises et extensions. L'interface existe en partie, mais tout n'est pas active ou finalise.

Installation

Prerequis

• macOS 15 Sequoia ou plus recent (Apple Silicon ou Intel).
• Xcode 16 ou plus recent uniquement si tu veux compiler depuis les sources.
• Certaines fonctions demandent des autorisations macOS : Accessibilite, Calendrier, Rappels, Camera ou Enregistrement d'ecran selon les options activees.

Téléchargement direct (.dmg) — recommandé

1. Va sur https://github.com/coaxel2/NotchIA/releases/latest.
2. Télécharge NotchIA-X.Y.Z.dmg.
3. Double-clique le .dmg puis glisse NotchIA.app dans le dossier Applications.
4. Premier lancement : voir la section Premier lancement et avertissement Gatekeeper ci-dessous.

Premier lancement et avertissement Gatekeeper

NotchIA est distribué gratuitement, hors Mac App Store. Apple ne notarize que les apps des développeurs inscrits au programme Apple Developer payant. NotchIA n'a pas cette signature officielle.

Conséquence : au tout premier lancement de NotchIA sur un Mac, macOS affiche un avertissement Gatekeeper. C'est normal et inoffensif. Procédure pour ouvrir l'app la première fois :

1. Ouvre Applications dans le Finder.
2. Clic droit (ou Ctrl + clic) sur NotchIA.
3. Choisis Ouvrir dans le menu contextuel.
4. Une fenêtre macOS demande confirmation : clique Ouvrir.

Si le clic droit ne fonctionne pas (cas possible sur macOS 15 Sequoia et 26 Tahoe) :

1. Ouvre Réglages système → Confidentialité et sécurité.
2. Scroll jusqu'à la section Sécurité en bas.
3. Clique "Ouvrir quand même" à côté du message « NotchIA a été empêchée de s'ouvrir ».
4. Confirme avec ton mot de passe Mac ou Touch ID.

Tu n'auras à faire cette étape qu'une seule fois. macOS approuve ensuite l'app pour les lancements suivants.

Cette procédure est la procédure officielle d'Apple pour ouvrir une app non Mac App Store. Tu n'as pas à désactiver Gatekeeper, lancer une commande Terminal sensible, ou contourner la sécurité macOS.

Depuis les sources

git clone https://github.com/coaxel2/NotchIA.git
cd NotchIA
open NotchIA.xcodeproj

Dans Xcode, selectionne le scheme NotchIA, puis lance avec Cmd + R.

Build en ligne de commande

xcodebuild -project NotchIA.xcodeproj -scheme NotchIA -configuration Debug -sdk macosx CODE_SIGNING_ALLOWED=NO build

Générer un .dmg distribuable

Le script scripts/build_dmg.sh compile l'app en Release (universal arm64 + x86_64), la signe en ad-hoc, et produit un .dmg prêt à uploader sur GitHub Releases ou ton site :

chmod +x scripts/build_dmg.sh
./scripts/build_dmg.sh

Le DMG est généré dans dist/NotchIA-<version>.dmg. Il contient NotchIA.app et un raccourci vers /Applications pour le drag-and-drop.

Le DMG produit est ad-hoc signé (pas Developer ID). Les utilisateurs verront un avertissement Gatekeeper au premier lancement, voir Premier lancement et avertissement Gatekeeper.

Mise à jour

NotchIA inclut Sparkle pour les mises à jour automatiques :

• Au démarrage de l'app et toutes les 24 h, Sparkle vérifie coaxel2.github.io/NotchIA/appcast.xml.
• Si une nouvelle version est disponible, une notification dans l'app propose le téléchargement.
• L'utilisateur clique « Installer », Sparkle remplace NotchIA.app et redémarre l'app.

Pour forcer une vérification manuelle : icône menubar ✨ → Vérifier les mises à jour.

Désinstallation

1. Quitte NotchIA depuis la barre de menu (✨ → Quitter).
2. Glisse NotchIA.app dans la corbeille depuis Applications.
3. Supprime aussi les fichiers de configuration utilisateur (optionnel) :
   • ~/Library/Preferences/com.coaxel2.notchia.plist
   • ~/Library/Application Support/NotchIA/
   • ~/Library/Containers/com.coaxel2.notchia/

Utilisation

1. Lance l'app.
2. Survole ou clique la notch pour l'ouvrir.
3. Utilise les onglets pour passer de Media a Shelf, Calendar, IA Code, Pomodoro ou Clipboard.
4. Depose des fichiers sur la notch pour les garder dans Shelf, les partager ou les convertir.
5. Ouvre les reglages depuis la barre des menus ou l'icone dans la notch pour ajuster les onglets, les autorisations et les comportements.

Permissions macOS

Certaines options ne peuvent pas fonctionner sans permissions systeme :

• Accessibilite : interception des touches media et remplacement du HUD systeme.
• Calendrier et Rappels : affichage des evenements et listes de rappels.
• Camera : NotchIA Mirror.
• Enregistrement d'ecran : detection et masquage pendant les captures, selon les reglages.

Si une fonction ne repond pas, commence par verifier ces autorisations dans System Settings > Privacy & Security.

Structure Du Projet

• NotchIA/ : app macOS SwiftUI principale.
• NotchIA/components/ : vues de notch, tabs, shelf, calendrier, IA Code, reglages, Pomodoro et presse-papiers.
• NotchIA/managers/ : logique metier pour media, IA, clipboard, webcam, focus, luminosite, volume et detection systeme.
• NotchIA/MediaControllers/ : integrations media Apple Music, Spotify, YouTube Music et Now Playing.
• NotchIAXPCHelper/ : helper XPC utilise pour certaines interactions systeme.
• Configuration/ : scripts de packaging.
• updater/ : appcast Sparkle.

Contribution

• Lis CONTRIBUTING.md avant d'ouvrir une pull request.
• Signale les problemes de securite via SECURITY.md.
• Les traductions passent par Crowdin.

Credits

NotchIA s'appuie sur un projet macOS open source existant et sur plusieurs projets tiers.

• MediaRemoteAdapter pour l'acces moderne a Now Playing sur macOS.
• NotchDrop pour l'inspiration autour du glisser-deposer dans la notch.

Les licences tierces sont listees dans THIRD_PARTY_LICENSES.

Licence

Ce projet est distribue selon les termes du fichier LICENSE.