AM • POSE & CLIP LIBRARY - Blender add-on (Animation Made suite)
================================================================
(Version francaise plus bas)

A library of POSES and animated CLIPS, shown as a carousel of thumbnails
at the bottom of the 3D Viewport. Save a pose or an animation once, reuse
it in one click. No internet connection, no AI.

Blender's own Pose Library only stores static poses. This add-on also
stores ANIMATIONS: a blink with your timing, a nod, a walk cycle, a wave...
and inserts them wherever you want in your timeline.


INSTALLATION (once)
-------------------
1. Open Blender 4.2 or newer.
2. Edit > Preferences > Add-ons > arrow at the top right > Install from Disk...
3. Pick  am_pose_clip_library.zip  (do not unzip it).
4. Tick "AM • Pose & Clip Library".
5. In the 3D Viewport, press  N  and open the "Animation Made" tab.
   The carousel shows up at the bottom of the viewport in Pose Mode.


1. CHARACTER (once per character)
---------------------------------
Pick your character's armature. The panel shows how thumbnails will look:
the whole character, framed automatically, whatever its size. No camera
needed.
   - 3/4 or Front: automatic framing.
   - My view: frame the viewport the way you like, click it, and every
     thumbnail of this character uses that exact view.
   - Refresh all thumbnails: redo every thumbnail saved in this file.


2. SAVE
-------
Give it a Name (written on the thumbnail), a Category (Expression, Body,
Hands, Other or your own: each category is a tab in the carousel), and
where to save it:
   - This file: inside the current .blend (kept when you save the file).
   - User Library: in your asset library folder, usable in EVERY file.

   Save pose   select the bones in Pose Mode, pose them, click.
   Save clip   select the bones, then their keyframes in the Dope Sheet,
               click. The clip keeps your exact timing. Its thumbnail
               shows its length (e.g. "12 frames" = from the first to the
               last selected key).


3. USE
------
   Click a POSE thumbnail   the character takes the pose (only the bones
                            of the pose change). With auto-key on (red
                            record button in the timeline), a keyframe is
                            added too.
   Click a CLIP thumbnail   the animation is inserted at the current frame.
                            Replace (default): the keys of those bones are
                            replaced over the clip's length.
                            Add: the clip is layered on top.
A message at the bottom of the screen confirms what happened.
Right-click a thumbnail for Apply / Insert and Refresh thumbnail.
Search: the field on the right of the carousel, or "Search" to open the
Asset Browser with all your poses and clips.


GOOD TO KNOW
------------
- Everything is stored as real Blender assets: rename, move or delete
  them in the Asset Browser.
- Thumbnails are sorted by name (Blender's rule). Use categories to group.
- Blender's native pose carousel is hidden while this add-on is on, so
  you only have one carousel. It comes back if you turn the add-on off.
- Shape keys are not stored (Blender's pose assets don't keep them).


==================================================
VERSION FRANCAISE
==================================================

Une bibliotheque de POSES et de CLIPS animes, en miniatures, en bas du
viewport 3D. Tu enregistres une pose ou une animation une fois, tu la
reutilises en un clic. Sans IA, sans connexion. L'interface est en
anglais, voici la correspondance.

La Pose Library de Blender ne garde que des poses fixes. Cet add-on garde
aussi des ANIMATIONS : un blink avec ton timing, un hochement de tete, un
cycle de marche, un coucou... et les insere ou tu veux dans ta timeline.

INSTALLATION
1. Blender 4.2 ou plus recent.
2. Edit > Preferences > Add-ons > fleche en haut a droite > Install from Disk...
3. Choisis  am_pose_clip_library.zip  (sans le decompresser).
4. Coche "AM • Pose & Clip Library".
5. Viewport 3D, touche  N , onglet "Animation Made". Le carrousel
   apparait en bas du viewport, en Mode Pose.

1. CHARACTER (le perso, une fois)
Choisis l'armature du perso. L'apercu montre les miniatures : le perso
entier, cadre automatiquement, sans camera. 3/4 ou Front (face), ou
My view (ton propre cadrage, memorise). Refresh all thumbnails refait
toutes les miniatures de ce fichier.

2. SAVE (enregistrer)
Name (nom, ecrit sur la miniature), Category (categorie = onglet du
carrousel), Save in : This file (dans ce .blend) ou User Library (dans
tous tes fichiers).
   Save pose : selectionne les os en Mode Pose, pose-les, clique.
   Save clip : selectionne les os, puis leurs cles dans le Dope Sheet,
               clique. Le clip garde ton timing exact ; sa miniature
               affiche sa duree (de la premiere a la derniere cle).

3. UTILISER
   Clic sur une POSE : le perso prend la pose (seuls ses os bougent).
   Auto-key allume = une cle est posee aussi.
   Clic sur un CLIP : l'animation est inseree a l'image courante.
   Replace (remplacer, par defaut) ou Add (ajouter par-dessus).
Un message en bas de l'ecran confirme ce qui s'est passe. Clic droit sur
une miniature : Apply / Insert et Refresh thumbnail.

BON A SAVOIR
- Tout est range en vrais assets Blender (Asset Browser).
- Les miniatures sont triees par nom (regle de Blender) : utilise les
  categories pour les grouper.
- Le carrousel de poses natif de Blender est masque tant que l'add-on est
  actif, pour n'en avoir qu'un seul.
- Les shape keys ne sont pas enregistrees.


LICENSE / LICENCE
-----------------
Copyright (C) 2026 Marie Dewulf - www.animation-made.com
GNU GPL v3 or later (see the LICENSE file / voir le fichier LICENSE).


Animation Made - AM • Pose & Clip Library v1.0
www.animation-made.com
