ShareX Manager

Vos captures, chez vous.

Le point de chute de vos captures d’écran, sur votre propre serveur. ShareX, Flameshot ou l’application Android envoient, ShareX Manager range, génère les miniatures et renvoie un lien public prêt à partager.

📖 Site · 📚 Wiki

Fonctionnalités

• Galerie en grille, en liste ou en détails, regroupée par mois, avec recherche, favoris et une frise chronologique pour remonter les années. La fenêtre « Ajouter » réunit les fichiers de l’ordinateur, une image d’un autre site et les contenus des modules.
• Visionneuse en plein écran ou en fenêtre, au choix dans les préférences ; elle détaille l’origine du fichier et propose l’original ou une version sans métadonnées.
• Liens publics par défaut : chaque capture envoyée est immédiatement partageable. Une capture peut être rendue privée depuis l’interface ; elle n’est alors visible que connecté.
• Albums à trois visibilités : privé (par défaut), public par lien, ou public et présenté dans le catalogue, une vitrine qui a sa propre navigation et n’expose rien d’autre.
• Clés API avec permissions par type de fichier, et configuration .sxcu générée pour ShareX (et Flameshot via fu).
• Historique et statistiques des envois, par jour, par méthode et par clé.
• Modules qui s’activent à la demande, chacun avec son logo :
  • traitements automatiques à l’envoi : filigrane (un texte, ou le logo d’une image de marque), redimensionnement, recadrage ;
  • AI Image Gen, un studio de génération et de retouche d’images (agents CLI connectés comme Codex, ou clés API) ;
  • Clip Studio, un éditeur de clips vidéo : timeline, modèles (quiz, classement, diaporama, avant / après), voix de synthèse locales, banque de musique libre de droits, sous-titres animés et rendu MP4 dans le navigateur. Une bibliothèque d’animations (entrées, sorties, mises en avant et boucles ; textes lettre par lettre, mot par mot ou ligne par ligne), 34 transitions, 19 mouvements de caméra et 8 effets de plan se choisissent dans l’éditeur, avec un aperçu animé. L’onglet « Trouver » cherche des images libres (Openverse), sur le web ou parmi les icônes officielles, licence et auteur à l’appui ;
  • l’assistant de Clip Studio (avec Codex) écrit le script, cherche une image qui existe avant d’en générer une, pose le logo officiel d’un jeu ou d’une marque, et vérifie les faits du script avec leurs sources ;
  • Image de marque, la direction artistique d’une chaîne : palette, polices, styles de texte, logos, mascotte, filigrane, carton de fin, ton et modèles de publication. Les modèles de Clip Studio et le filigrane des captures la suivent ; les formats d’une chaîne (bannière YouTube, avatar, en-tête X, couverture de short…) s’exportent en PNG ;
  • Recherche inversée, qui interroge plusieurs moteurs d’un coup (trace.moe, IQDB, SauceNAO, Google Lens, Yandex) et garde un historique.
• Exports et publication : chaque clip rendu a sa fiche (couverture, sous-titres .srt, crédits, volume mesuré) et ses textes de publication, communs ou propres à chaque service, préremplis par l’image de marque. Il part vers un ou plusieurs comptes connectés : YouTube, Facebook (pages), Instagram (compte professionnel) et Threads ; X est annoncé. Envoi repris après une coupure, programmation, quotas, premier commentaire, sous-titres et couverture posés après la mise en ligne. Chaque service demande de créer sa propre application (Google Cloud, Meta for Developers) : la marche à suivre est dans le wiki.
• Outils publics, ouverts sans compte : « Origine d’une image » lit ce qu’un fichier déclare (manifeste C2PA, EXIF, XMP, paramètres de génération) sans rien enregistrer.
• Application Android (sharex-mobile/) pour envoyer depuis le partage du téléphone.
• Authentification intégrée (comptes créés par l’administrateur) ou via Ascencia ID en OIDC.
• Thème global : l’administrateur règle le mode et les couleurs du site à partir de 42 palettes ; chaque navigateur choisit ensuite clair, sombre ou système.
• Interface en français et en anglais, adaptée au mobile.

Accueil	Visionneuse
Albums	Catalogue public
Statistiques	Clés API et configuration ShareX
Clip Studio	Bibliothèque d’animations
Trouver une image	Exporter
Fiche d’un export	Publier
Image de marque	Éditeur d’une image de marque
Comptes connectés	Connecter un compte
Filigrane de la marque	AI Image Gen
Recherche inversée	Origine d’une image
Modules	Thème global

Un clip rendu par Clip Studio, avec l’image de marque inventée « Altitude Claire » de l’instance de test :

D’autres captures (thème clair, mobile, historique, préférences, connexion, administration, Publier et fiche d’un export sur téléphone) sont dans docs/images/.

Installation

Prérequis : Bun 1.3 ou plus récent.

git clone https://github.com/pedrokarim/sharex-manager.git
cd sharex-manager
bun install
bun run setup
bun dev

L’assistant bun run setup demande l’URL publique, le port et le mode d’authentification, génère les secrets et crée le premier administrateur. L’inscription libre est fermée : les comptes suivants se créent depuis l’administration. Le mode automatisé et Ascencia ID sont décrits dans le guide d’authentification.

Ouvrez ensuite l’URL choisie (par défaut http://localhost:3000).

Avec Docker

bun run setup            # crée .env et config/uploads.json
docker compose up -d --build

Les données (uploads/, data/, config/, données des modules) restent sur l’hôte, dans des volumes. Voir la sécurité du déploiement et le redéploiement automatique.

Envoyer ses captures

Dans l’interface : Paramètres → Clés API → Nouvelle clé, puis l’onglet « Configuration ShareX » de la clé, et Copier.

• 🪟 Windows, avec ShareX : collez la configuration dans un fichier sharex-manager.sxcu, double-cliquez-le, capturez. Guide pas à pas.
• 🐧 Linux, avec Flameshot et fu (flameshot-uploader), qui lit le même .sxcu. Guide pas à pas.
• 📱 Android : l’application de sharex-mobile/ se configure en scannant le QR code de la clé.

Technologies

• Next.js 16 (App Router, Turbopack) et React 19
• Bun pour l’exécution, les scripts et le CLI
• better-auth pour l’authentification, Ascencia ID en option
• Tailwind CSS 4, shadcn/ui, Framer Motion, icônes Lucide
• Sharp pour les miniatures et les traitements d’images
• Mediabunny et Piper pour l’export vidéo et les voix de Clip Studio
• Expo pour l’application Android

Structure du projet

sharex-manager/
├── src/
│   ├── app/            # Pages et routes API (App Router)
│   ├── components/     # Composants React (ui/ = shadcn/ui)
│   ├── lib/            # Logique serveur et utilitaires
│   ├── hooks/          # Hooks React
│   ├── proxy.ts        # Proxy Next.js (en-têtes, routes publiques)
│   └── instrumentation.ts
├── modules/            # Modules (AI Image Gen, Clip Studio, Recherche inversée…)
├── cli/                # CLI : bun run setup, journaux, déploiement
├── scripts/            # Scripts de maintenance et de release
├── tests/              # Tests Vitest
├── public/             # Fichiers statiques
├── config/             # Réglages d’exécution (uploads.json)
├── docs/               # Documentation et captures
│   └── website/        # Site GitHub Pages
└── sharex-mobile/      # Application Android (Expo)

Développement

bun dev                  # serveur de développement
bun run test             # tests (Vitest)
bun run build            # build de production

Avant de contribuer, lisez AGENTS.md et le guide du composant concerné dans .agents/.

Versions et releases

Le serveur et l’application mobile ont des versions indépendantes (tags server-vX.Y.Z et mobile-vX.Y.Z, SemVer) et chacun son changelog. Voir la politique de versioning, le changelog serveur et le changelog mobile.

Licence

GNU General Public License v3.0. Voir LICENSE.

Les photos visibles sur les captures d’écran viennent de Lorem Picsum (photos Unsplash, libres d’utilisation) et d’Openverse (CC0).