oledgifstudio 0.1.0__tar.gz

oledgifstudio-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MaticeMrll
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

oledgifstudio-0.1.0/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.4
+Name: oledgifstudio
+Version: 0.1.0
+Summary: Générateur de GIFs animés 1 bit pour écrans OLED (SteelSeries, SSD1306, ...)
+Author-email: MaticeMrll <marill.matice@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 MaticeMrll
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/MaticeMrll/oled-gif-studio
+Project-URL: Repository, https://github.com/MaticeMrll/oled-gif-studio
+Project-URL: Issues, https://github.com/MaticeMrll/oled-gif-studio/issues
+Keywords: oled,gif,steelseries,ssd1306,keyboard,pillow
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Environment :: Console
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=9.0
+Dynamic: license-file
+
+# oled-gif-studio
+
+<p align="center">
+  <img src="docs/hero.gif" width="384" alt="OLED GIF STUDIO qui défile sur un écran 128x40">
+</p>
+
+Générateur de GIFs animés **1 bit** pour les petits écrans OLED : claviers/souris
+SteelSeries, modules SSD1306/SH1106 (Arduino, Raspberry Pi, macropads QMK)...
+
+Pas de modèle IA, pas d'API payante : tout est **procédural** (Python + Pillow),
+donc instantané, gratuit et pixel-perfect. Un mode « description en langage
+naturel » (français ou anglais) choisit l'effet et les paramètres pour toi.
+
+> Tous les aperçus de ce README sont agrandis ×3 — la taille réelle des GIFs
+> est celle de l'écran cible (128×40 par défaut).
+
+## Installation
+
+Aucune, si Python (≥ 3.10) + Pillow sont déjà installés. Sinon :
+
+```
+pip install Pillow
+```
+
+Optionnel, pour avoir la commande `oledgif` partout :
+
+```
+pip install -e .
+```
+
+## Usage rapide
+
+```powershell
+# Depuis le dossier du projet :
+python -m oledgif "HELLO WORLD"                          # effet auto → hello.gif
+python -m oledgif "GG" -e slot -o gg.gif                 # machine à sous
+python -m oledgif "PWNED" -e glitch -p rival             # pour l'OLED d'une souris
+python -m oledgif "42" -e matrix --size 128x64 --fps 20  # taille custom
+
+# En langage naturel :
+python -m oledgif -d "le texte 'BONJOUR' défile lentement"
+python -m oledgif -d "'GAME OVER' qui clignote vite pendant 3s"
+python -m oledgif -d "un radar qui balaie l'écran"
+
+# À partir d'une image :
+python -m oledgif -i photo.jpg --fit cover               # photo plein écran, effet vhs
+python -m oledgif -i comic.jpg --fit cover --style comic # illustration/BD
+python -m oledgif -i logo.png -e bounce                  # le logo rebondit
+python -m oledgif -i meme.gif                            # GIF animé converti tel quel
+
+# Motifs sans texte (écrans de veille) :
+python -m oledgif -e starfield
+python -m oledgif -e plasma --seconds 6
+
+# Un exemple de chaque effet dans ./samples :
+python -m oledgif --demo
+```
+
+## Effets texte / image (`--list-effects`)
+
+<table>
+<tr>
+<td align="center"><img src="docs/scroll.gif" alt="scroll"><br><code>scroll</code> — défilement en boucle parfaite</td>
+<td align="center"><img src="docs/typewriter.gif" alt="typewriter"><br><code>typewriter</code> — machine à écrire avec curseur</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/wave.gif" alt="wave"><br><code>wave</code> — lettres en vague</td>
+<td align="center"><img src="docs/blink.gif" alt="blink"><br><code>blink</code> — clignotement</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/bounce.gif" alt="bounce"><br><code>bounce</code> — rebond façon logo DVD</td>
+<td align="center"><img src="docs/matrix.gif" alt="matrix"><br><code>matrix</code> — pluie de caractères qui révèle le texte</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/slot.gif" alt="slot"><br><code>slot</code> — chaque lettre cycle puis se fige</td>
+<td align="center"><img src="docs/glitch.gif" alt="glitch"><br><code>glitch</code> — bandes décalées + bruit</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/pulse.gif" alt="pulse"><br><code>pulse</code> — battement de cœur</td>
+<td align="center"><img src="docs/vhs.gif" alt="vhs"><br><code>vhs</code> — tracking façon cassette vidéo</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/slide.gif" alt="slide"><br><code>slide</code> — générique bas → haut</td>
+<td></td>
+</tr>
+</table>
+
+`typewriter`, `wave`, `matrix` et `slot` sont réservés au texte ; les autres
+acceptent aussi une image (`--image`).
+
+`--effect auto` (défaut) : `scroll` si le texte est trop large pour l'écran,
+sinon `wave` ; `vhs` pour une image ; conversion directe pour un GIF animé.
+
+## Motifs sans texte (écrans de veille)
+
+<table>
+<tr>
+<td align="center"><img src="docs/starfield.gif" alt="starfield"><br><code>starfield</code> — hyperespace</td>
+<td align="center"><img src="docs/plasma.gif" alt="plasma"><br><code>plasma</code> — plasma rétro tramé</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/life.gif" alt="life"><br><code>life</code> — jeu de la vie de Conway</td>
+<td align="center"><img src="docs/eq.gif" alt="eq"><br><code>eq</code> — égaliseur audio</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/scope.gif" alt="scope"><br><code>scope</code> — oscilloscope</td>
+<td align="center"><img src="docs/radar.gif" alt="radar"><br><code>radar</code> — balayage avec échos</td>
+</tr>
+</table>
+
+## Images : les 4 styles de rendu
+
+Convertir une image couleur en 1 bit sur 5120 pixels est un exercice de
+sacrifice — le bon `--style` dépend de la source. Démonstration sur la même
+scène (lune, silhouettes sur ciel en dégradé, lumières de ville) :
+
+| Rendu | Style |
+|---|---|
+| <img src="docs/style_source.png" alt="source" width="288"> | **Source** (niveaux de gris) |
+| <img src="docs/style_photo.png" alt="photo" width="288"> | `--style photo` (défaut) — auto-contraste + netteté + trame Floyd-Steinberg. Le bon choix pour les **photos réelles** : la trame simule les niveaux de gris. Sur une illustration, elle devient du bruit. |
+| <img src="docs/style_solid.png" alt="solid" width="288"> | `--style solid` — seuillage net (alias `--no-dither`). Parfait pour les **logos** et dessins au trait… mais tout ce qui est sombre-sur-sombre disparaît dans le noir. |
+| <img src="docs/style_comic.png" alt="comic" width="288"> | `--style comic` — comme `solid`, mais un 2ᵉ seuil automatique (Otsu) sépare les tons sombres et retrace en **contour blanc** les formes noyées dans le noir. Idéal pour les **illustrations/BD**. |
+| <img src="docs/style_edges.png" alt="edges" width="288"> | `--style edges` — détection de contours, traits blancs sur fond noir. Look néon/filaire, souvent le plus lisible pour un **paysage ou un visage**. |
+
+Autres options d'image :
+
+- `--fit cover` — l'image remplit tout l'écran (recadrée) au lieu d'être
+  réduite à un timbre-poste au milieu. Recommandé pour les photos paysage.
+- **Dé-bruitage** (actif par défaut) : un filtre médian + une suppression des
+  pixels isolés éliminent le « poivre et sel » (reflets, lampadaires, étoiles).
+  `--no-denoise` le désactive si tu veux justement garder ces points.
+- Un **GIF animé** en entrée est converti frame par frame en conservant les
+  durées d'origine (avec `--effect auto`).
+
+## Langage naturel (`--describe`)
+
+```powershell
+python -m oledgif -d "le texte 'BRB' qui rebondit pendant 5 secondes"
+python -m oledgif -d "'REC' en mode vhs vintage"
+python -m oledgif -d "a fast blinking 'GO' for 3 seconds"
+```
+
+Le parseur (FR/EN, insensible aux accents) reconnaît l'effet par mots-clés
+(« défile », « clignote », « tape », « radar », « vintage »…), le texte entre
+guillemets, la durée (« pendant 3s ») et la vitesse (« lentement », « vite »).
+
+## Écrans préconfigurés (`--list-presets`)
+
+| Preset        | Taille  | Matériel |
+|---------------|---------|----------|
+| `apex` (défaut) | 128×40 | SteelSeries Apex 5 / 7 / Pro (OLED clavier) |
+| `rival`       | 128×36  | SteelSeries Rival 700 / 710 (OLED souris) |
+| `oled-128x64` | 128×64  | SSD1306 / SH1106 / SSD1309 |
+| `oled-128x32` | 128×32  | SSD1306 |
+| `oled-96x16`  | 96×16   | SSD1306 |
+| `oled-256x64` | 256×64  | SSD1322 |
+
+N'importe quelle autre taille : `--size LARGEURxHAUTEUR`.
+
+## Options utiles
+
+- `--charset alnum|digits|upper|letters|ascii` ou une chaîne littérale — le
+  jeu de caractères utilisé par `matrix` et `slot` (défaut : les 62
+  alphanumériques `0-9A-Za-z`).
+- `--font chemin.ttf --font-size N` — police custom (défaut : Consolas,
+  taille ajustée à l'écran).
+- `--invert` — noir sur blanc.
+- `--scale 4` — GIF agrandi ×4 (pour prévisualiser confortablement).
+- `--seed 42` — rendu reproductible pour les effets aléatoires.
+- `--fps`, `--seconds`, `--speed` (px/s pour scroll).
+
+## Envoyer le GIF sur l'écran SteelSeries
+
+Deux options :
+
+1. **SteelSeries GG** : dans les réglages de ton clavier (section OLED),
+   tu peux importer une image/GIF 128×40 — les GIFs générés ici sont au bon
+   format (1 bit, taille exacte).
+2. **GameSense API** (programmatique) : comme le fait
+   [SteelseriesAnimGif](https://github.com/bolner/SteelseriesAnimGif), on peut
+   streamer les frames vers l'écran via l'API locale de SteelSeries GG.
+   Les GIFs produits ici sont directement exploitables frame par frame.
+
+## Structure du projet
+
+```
+oledgif/
+  cli.py        # ligne de commande + make_gif()
+  effects.py    # les 11 effets texte/image (registre @effect)
+  patterns.py   # les 6 motifs sans texte
+  render.py     # préparation d'images, binarisation, écriture GIF
+  describe.py   # parseur langage naturel FR/EN
+  presets.py    # tailles d'écrans du marché
+  fonts.py      # chargement de police
+samples/        # un GIF d'exemple par effet (taille réelle, --demo)
+docs/           # illustrations du README (agrandies ×3)
+```
+--- 
+## Mon choix
+
+<img src="docs/keyboard.jpg" alt="source" width="288">
+
+Ninja Turtles !

oledgifstudio-0.1.0/README.md

@@ -0,0 +1,203 @@
+# oled-gif-studio
+
+<p align="center">
+  <img src="docs/hero.gif" width="384" alt="OLED GIF STUDIO qui défile sur un écran 128x40">
+</p>
+
+Générateur de GIFs animés **1 bit** pour les petits écrans OLED : claviers/souris
+SteelSeries, modules SSD1306/SH1106 (Arduino, Raspberry Pi, macropads QMK)...
+
+Pas de modèle IA, pas d'API payante : tout est **procédural** (Python + Pillow),
+donc instantané, gratuit et pixel-perfect. Un mode « description en langage
+naturel » (français ou anglais) choisit l'effet et les paramètres pour toi.
+
+> Tous les aperçus de ce README sont agrandis ×3 — la taille réelle des GIFs
+> est celle de l'écran cible (128×40 par défaut).
+
+## Installation
+
+Aucune, si Python (≥ 3.10) + Pillow sont déjà installés. Sinon :
+
+```
+pip install Pillow
+```
+
+Optionnel, pour avoir la commande `oledgif` partout :
+
+```
+pip install -e .
+```
+
+## Usage rapide
+
+```powershell
+# Depuis le dossier du projet :
+python -m oledgif "HELLO WORLD"                          # effet auto → hello.gif
+python -m oledgif "GG" -e slot -o gg.gif                 # machine à sous
+python -m oledgif "PWNED" -e glitch -p rival             # pour l'OLED d'une souris
+python -m oledgif "42" -e matrix --size 128x64 --fps 20  # taille custom
+
+# En langage naturel :
+python -m oledgif -d "le texte 'BONJOUR' défile lentement"
+python -m oledgif -d "'GAME OVER' qui clignote vite pendant 3s"
+python -m oledgif -d "un radar qui balaie l'écran"
+
+# À partir d'une image :
+python -m oledgif -i photo.jpg --fit cover               # photo plein écran, effet vhs
+python -m oledgif -i comic.jpg --fit cover --style comic # illustration/BD
+python -m oledgif -i logo.png -e bounce                  # le logo rebondit
+python -m oledgif -i meme.gif                            # GIF animé converti tel quel
+
+# Motifs sans texte (écrans de veille) :
+python -m oledgif -e starfield
+python -m oledgif -e plasma --seconds 6
+
+# Un exemple de chaque effet dans ./samples :
+python -m oledgif --demo
+```
+
+## Effets texte / image (`--list-effects`)
+
+<table>
+<tr>
+<td align="center"><img src="docs/scroll.gif" alt="scroll"><br><code>scroll</code> — défilement en boucle parfaite</td>
+<td align="center"><img src="docs/typewriter.gif" alt="typewriter"><br><code>typewriter</code> — machine à écrire avec curseur</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/wave.gif" alt="wave"><br><code>wave</code> — lettres en vague</td>
+<td align="center"><img src="docs/blink.gif" alt="blink"><br><code>blink</code> — clignotement</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/bounce.gif" alt="bounce"><br><code>bounce</code> — rebond façon logo DVD</td>
+<td align="center"><img src="docs/matrix.gif" alt="matrix"><br><code>matrix</code> — pluie de caractères qui révèle le texte</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/slot.gif" alt="slot"><br><code>slot</code> — chaque lettre cycle puis se fige</td>
+<td align="center"><img src="docs/glitch.gif" alt="glitch"><br><code>glitch</code> — bandes décalées + bruit</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/pulse.gif" alt="pulse"><br><code>pulse</code> — battement de cœur</td>
+<td align="center"><img src="docs/vhs.gif" alt="vhs"><br><code>vhs</code> — tracking façon cassette vidéo</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/slide.gif" alt="slide"><br><code>slide</code> — générique bas → haut</td>
+<td></td>
+</tr>
+</table>
+
+`typewriter`, `wave`, `matrix` et `slot` sont réservés au texte ; les autres
+acceptent aussi une image (`--image`).
+
+`--effect auto` (défaut) : `scroll` si le texte est trop large pour l'écran,
+sinon `wave` ; `vhs` pour une image ; conversion directe pour un GIF animé.
+
+## Motifs sans texte (écrans de veille)
+
+<table>
+<tr>
+<td align="center"><img src="docs/starfield.gif" alt="starfield"><br><code>starfield</code> — hyperespace</td>
+<td align="center"><img src="docs/plasma.gif" alt="plasma"><br><code>plasma</code> — plasma rétro tramé</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/life.gif" alt="life"><br><code>life</code> — jeu de la vie de Conway</td>
+<td align="center"><img src="docs/eq.gif" alt="eq"><br><code>eq</code> — égaliseur audio</td>
+</tr>
+<tr>
+<td align="center"><img src="docs/scope.gif" alt="scope"><br><code>scope</code> — oscilloscope</td>
+<td align="center"><img src="docs/radar.gif" alt="radar"><br><code>radar</code> — balayage avec échos</td>
+</tr>
+</table>
+
+## Images : les 4 styles de rendu
+
+Convertir une image couleur en 1 bit sur 5120 pixels est un exercice de
+sacrifice — le bon `--style` dépend de la source. Démonstration sur la même
+scène (lune, silhouettes sur ciel en dégradé, lumières de ville) :
+
+| Rendu | Style |
+|---|---|
+| <img src="docs/style_source.png" alt="source" width="288"> | **Source** (niveaux de gris) |
+| <img src="docs/style_photo.png" alt="photo" width="288"> | `--style photo` (défaut) — auto-contraste + netteté + trame Floyd-Steinberg. Le bon choix pour les **photos réelles** : la trame simule les niveaux de gris. Sur une illustration, elle devient du bruit. |
+| <img src="docs/style_solid.png" alt="solid" width="288"> | `--style solid` — seuillage net (alias `--no-dither`). Parfait pour les **logos** et dessins au trait… mais tout ce qui est sombre-sur-sombre disparaît dans le noir. |
+| <img src="docs/style_comic.png" alt="comic" width="288"> | `--style comic` — comme `solid`, mais un 2ᵉ seuil automatique (Otsu) sépare les tons sombres et retrace en **contour blanc** les formes noyées dans le noir. Idéal pour les **illustrations/BD**. |
+| <img src="docs/style_edges.png" alt="edges" width="288"> | `--style edges` — détection de contours, traits blancs sur fond noir. Look néon/filaire, souvent le plus lisible pour un **paysage ou un visage**. |
+
+Autres options d'image :
+
+- `--fit cover` — l'image remplit tout l'écran (recadrée) au lieu d'être
+  réduite à un timbre-poste au milieu. Recommandé pour les photos paysage.
+- **Dé-bruitage** (actif par défaut) : un filtre médian + une suppression des
+  pixels isolés éliminent le « poivre et sel » (reflets, lampadaires, étoiles).
+  `--no-denoise` le désactive si tu veux justement garder ces points.
+- Un **GIF animé** en entrée est converti frame par frame en conservant les
+  durées d'origine (avec `--effect auto`).
+
+## Langage naturel (`--describe`)
+
+```powershell
+python -m oledgif -d "le texte 'BRB' qui rebondit pendant 5 secondes"
+python -m oledgif -d "'REC' en mode vhs vintage"
+python -m oledgif -d "a fast blinking 'GO' for 3 seconds"
+```
+
+Le parseur (FR/EN, insensible aux accents) reconnaît l'effet par mots-clés
+(« défile », « clignote », « tape », « radar », « vintage »…), le texte entre
+guillemets, la durée (« pendant 3s ») et la vitesse (« lentement », « vite »).
+
+## Écrans préconfigurés (`--list-presets`)
+
+| Preset        | Taille  | Matériel |
+|---------------|---------|----------|
+| `apex` (défaut) | 128×40 | SteelSeries Apex 5 / 7 / Pro (OLED clavier) |
+| `rival`       | 128×36  | SteelSeries Rival 700 / 710 (OLED souris) |
+| `oled-128x64` | 128×64  | SSD1306 / SH1106 / SSD1309 |
+| `oled-128x32` | 128×32  | SSD1306 |
+| `oled-96x16`  | 96×16   | SSD1306 |
+| `oled-256x64` | 256×64  | SSD1322 |
+
+N'importe quelle autre taille : `--size LARGEURxHAUTEUR`.
+
+## Options utiles
+
+- `--charset alnum|digits|upper|letters|ascii` ou une chaîne littérale — le
+  jeu de caractères utilisé par `matrix` et `slot` (défaut : les 62
+  alphanumériques `0-9A-Za-z`).
+- `--font chemin.ttf --font-size N` — police custom (défaut : Consolas,
+  taille ajustée à l'écran).
+- `--invert` — noir sur blanc.
+- `--scale 4` — GIF agrandi ×4 (pour prévisualiser confortablement).
+- `--seed 42` — rendu reproductible pour les effets aléatoires.
+- `--fps`, `--seconds`, `--speed` (px/s pour scroll).
+
+## Envoyer le GIF sur l'écran SteelSeries
+
+Deux options :
+
+1. **SteelSeries GG** : dans les réglages de ton clavier (section OLED),
+   tu peux importer une image/GIF 128×40 — les GIFs générés ici sont au bon
+   format (1 bit, taille exacte).
+2. **GameSense API** (programmatique) : comme le fait
+   [SteelseriesAnimGif](https://github.com/bolner/SteelseriesAnimGif), on peut
+   streamer les frames vers l'écran via l'API locale de SteelSeries GG.
+   Les GIFs produits ici sont directement exploitables frame par frame.
+
+## Structure du projet
+
+```
+oledgif/
+  cli.py        # ligne de commande + make_gif()
+  effects.py    # les 11 effets texte/image (registre @effect)
+  patterns.py   # les 6 motifs sans texte
+  render.py     # préparation d'images, binarisation, écriture GIF
+  describe.py   # parseur langage naturel FR/EN
+  presets.py    # tailles d'écrans du marché
+  fonts.py      # chargement de police
+samples/        # un GIF d'exemple par effet (taille réelle, --demo)
+docs/           # illustrations du README (agrandies ×3)
+```
+--- 
+## Mon choix
+
+<img src="docs/keyboard.jpg" alt="source" width="288">
+
+Ninja Turtles !

oledgifstudio-0.1.0/oledgif/__init__.py

@@ -0,0 +1,3 @@
+"""oledgif — générateur de GIFs animés pour écrans OLED (SteelSeries, SSD1306, ...)."""
+
+__version__ = "0.1.0"

oledgifstudio-0.1.0/oledgif/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

oledgifstudio-0.1.0/oledgif/cli.py

@@ -0,0 +1,176 @@
+"""CLI : python -m oledgif "TEXTE" [options]"""
+
+import argparse
+import os
+import random
+import string
+import sys
+
+from . import __version__
+from .describe import parse as parse_description
+from .effects import ALNUM, DESCRIPTIONS, EFFECTS, Ctx
+from .fonts import load_font
+from .patterns import PATTERNS
+from .presets import DEFAULT_PRESET, PRESETS, resolve_size
+from .render import convert_animation, load_source, save_gif
+
+from PIL import Image
+
+CHARSETS = {
+    "alnum": ALNUM,
+    "digits": string.digits,
+    "upper": string.digits + string.ascii_uppercase,
+    "letters": string.ascii_letters,
+    "ascii": "".join(c for c in string.printable if c.isprintable() and c != " "),
+}
+
+
+def build_parser():
+    p = argparse.ArgumentParser(
+        prog="oledgif",
+        description="Génère des GIFs animés 1 bit pour écrans OLED (SteelSeries, SSD1306...).",
+    )
+    p.add_argument("text", nargs="?", help="texte à animer (optionnel avec --image ou un motif)")
+    p.add_argument("-d", "--describe", metavar="PHRASE",
+                   help="décrire l'animation en langage naturel, ex: 'GG qui clignote vite'")
+    p.add_argument("-i", "--image", metavar="FICHIER",
+                   help="image source (PNG/JPG/GIF...) : convertie en 1 bit avec tramage ; "
+                        "un GIF animé est converti tel quel si --effect vaut auto/convert")
+    p.add_argument("--style", default="photo", choices=["photo", "solid", "comic", "edges"],
+                   help="rendu de --image : photo = contraste+netteté+tramage (défaut), "
+                        "solid = seuillage net (logos), comic = solid + contours blancs "
+                        "des formes perdues dans le noir (illustrations), "
+                        "edges = contours blancs sur noir")
+    p.add_argument("--fit", default="contain", choices=["contain", "cover"],
+                   help="contain = image entière (défaut), cover = remplit l'écran en "
+                        "recadrant — recommandé pour les photos paysage")
+    p.add_argument("--no-dither", action="store_true",
+                   help="alias de --style solid")
+    p.add_argument("--no-denoise", action="store_true",
+                   help="garde le bruit : désactive le filtre médian et la suppression "
+                        "des pixels isolés (reflets, sources de lumière ponctuelles)")
+    p.add_argument("-o", "--out", default=None, help="fichier de sortie (.gif)")
+    p.add_argument("-p", "--preset", default=None,
+                   help=f"écran cible (défaut: {DEFAULT_PRESET}) — voir --list-presets")
+    p.add_argument("--size", default=None, metavar="WxH", help="taille custom, ex: 128x40")
+    p.add_argument("-e", "--effect", default="auto",
+                   help="effet (défaut: auto) — voir --list-effects")
+    p.add_argument("--fps", type=int, default=15)
+    p.add_argument("--seconds", type=float, default=4.0, help="durée cible (certains effets la déduisent)")
+    p.add_argument("--speed", type=float, default=None, help="vitesse de défilement en px/s (scroll)")
+    p.add_argument("--font", default=None, help="chemin d'une police .ttf")
+    p.add_argument("--font-size", type=int, default=None)
+    p.add_argument("--charset", default="alnum",
+                   help="alnum|digits|upper|letters|ascii ou chaîne littérale (matrix/slot)")
+    p.add_argument("--invert", action="store_true", help="noir sur blanc")
+    p.add_argument("--scale", type=int, default=1, help="agrandit le GIF xN (aperçu)")
+    p.add_argument("--seed", type=int, default=None, help="graine aléatoire (rendu reproductible)")
+    p.add_argument("--demo", action="store_true", help="génère un exemple de chaque effet dans ./samples")
+    p.add_argument("--list-effects", action="store_true")
+    p.add_argument("--list-presets", action="store_true")
+    p.add_argument("--version", action="version", version=f"oledgif {__version__}")
+    return p
+
+
+def make_gif(text, out, *, preset=None, size=None, effect="auto", fps=15, seconds=4.0,
+             speed=None, font_path=None, font_size=None, charset=ALNUM,
+             invert=False, scale=1, seed=None, image=None, style="photo", fit="contain",
+             denoise=True):
+    W, H = resolve_size(preset, size)
+    font = load_font(font_path, font_size, screen_h=H)
+
+    src = None
+    if image:
+        im = Image.open(image)
+        if getattr(im, "is_animated", False) and effect in ("auto", "convert"):
+            # GIF animé -> conversion frame par frame, durées d'origine conservées
+            frames, durations = convert_animation(image, W, H, style, fit, denoise)
+            n, duration = save_gif(frames, out, fps=fps, invert=invert,
+                                   scale=scale, durations=durations)
+            return out, "convert", W, H, n, duration
+        im.close()
+        src = load_source(image, W, H, style, fit, denoise)
+        if effect in ("auto", "convert"):
+            effect = "vhs"
+
+    if effect == "auto":
+        try:
+            wide = font.getlength(text) > W - 4
+        except AttributeError:
+            wide = len(text) * 7 > W - 4
+        effect = "scroll" if wide else "wave"
+    if effect not in EFFECTS:
+        raise SystemExit(f"Effet inconnu: {effect!r}. Effets: {', '.join(EFFECTS)}")
+
+    ctx = Ctx(text=text or "", W=W, H=H, fps=fps, seconds=seconds, font=font,
+              font_path=font_path, font_size=font_size, charset=charset,
+              speed=speed, src=src, rng=random.Random(seed))
+    frames = EFFECTS[effect](ctx)
+    n, duration = save_gif(frames, out, fps=fps, invert=invert, scale=scale)
+    return out, effect, W, H, n, duration
+
+
+def main(argv=None):
+    args = build_parser().parse_args(argv)
+
+    if args.list_effects:
+        for name, desc in DESCRIPTIONS.items():
+            print(f"  {name:<11} {desc}")
+        return 0
+    if args.list_presets:
+        for name, (w, h, desc) in PRESETS.items():
+            print(f"  {name:<12} {w}x{h:<4} {desc}")
+        return 0
+
+    charset = CHARSETS.get(args.charset, args.charset)
+
+    if args.demo:
+        outdir = "samples"
+        os.makedirs(outdir, exist_ok=True)
+        text = args.text or "GG WP 42"
+        for name in EFFECTS:
+            out = os.path.join(outdir, f"{name}.gif")
+            make_gif(text, out, preset=args.preset, size=args.size, effect=name,
+                     fps=args.fps, seconds=args.seconds, speed=args.speed,
+                     font_path=args.font, font_size=args.font_size, charset=charset,
+                     invert=args.invert, scale=args.scale, seed=args.seed or 42)
+            print(f"  {out}")
+        return 0
+
+    text, effect, fps, seconds = args.text, args.effect, args.fps, args.seconds
+    if args.describe:
+        parsed = parse_description(args.describe)
+        text = parsed.get("text", text)
+        if effect == "auto":
+            effect = parsed.get("effect", "auto")
+        fps = parsed.get("fps", fps)
+        seconds = parsed.get("seconds", seconds)
+
+    textless_ok = args.image or effect in PATTERNS or effect == "matrix"
+    if not text and not textless_ok:
+        print("Erreur: aucun texte. Passe-le en argument, entre guillemets dans --describe, "
+              "ou utilise --image / un motif (starfield, plasma, life, eq, scope, radar).",
+              file=sys.stderr)
+        return 2
+
+    if args.out:
+        out = args.out
+    elif text:
+        out = "".join(c if c.isalnum() else "_" for c in text)[:24] + ".gif"
+    elif args.image:
+        out = os.path.splitext(os.path.basename(args.image))[0] + "_oled.gif"
+    else:
+        out = f"{effect}.gif"
+    out, effect, W, H, n, duration = make_gif(
+        text, out, preset=args.preset, size=args.size, effect=effect, fps=fps,
+        seconds=seconds, speed=args.speed, font_path=args.font,
+        font_size=args.font_size, charset=charset, invert=args.invert,
+        scale=args.scale, seed=args.seed, image=args.image,
+        style="solid" if args.no_dither else args.style, fit=args.fit,
+        denoise=not args.no_denoise)
+    print(f"{out}  —  {W}x{H}, effet {effect}, {n} frames @ {duration} ms")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())