From d341cae7b5a59ebfc273bb5ac003fb9f623a0021 Mon Sep 17 00:00:00 2001
From: Mars-Marcelyn <vicky.vmv@gmail.com>
Date: Thu, 18 Jun 2026 19:57:45 +0200
Subject: [PATCH] Update README.md

---
 README.md | 38 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 2a91f5f..49aef19 100644
--- a/README.md
+++ b/README.md
@@ -2,12 +2,28 @@
 
 Timed, randomized fullscreen image slideshows for drawing practice, presentations, and more.
 
+## What's new in 1.0.4
+
+### New features
+- Break system — configurable break frequency, duration presets, custom break duration, fullscreen break overlay with countdown
+- Infinite time mode — manual-only navigation, no auto-advance, JSON-safe persistence
+- Settings UI groups with dividers for cleaner layout
+- Break timer warning color when session will expire mid-break
+- Disable breaks when Infinite duration is selected, with descriptive warning
+- Timer display uses adaptive format (s / m:s / h:m:s)
+
+### Bug fixes
+- Custom duration inputs now capped at 9999s with digits-only validation
+- End-of-deck screen waits for user input instead of auto-advancing
+- Session description text updated to reflect breaks in total time calculation
+
 ## Features
 
 - Fullscreen slideshow with randomized images from any vault folder
-- Configurable duration per image with presets (30s, 60s, 2min, 5min, custom)
+- Configurable duration per image with presets (30s, 60s, 2min, 5min, custom, infinite)
 - Loop toggle — choose whether to repeat images or stop when they run out
 - Session timer with real-time display
+- Break system — configurable break frequency and duration between images
 - Intro prompt slide (optional markdown file per folder)
 - Session logging to prioritize unseen images next session
 - Language support (desktop only)
@@ -36,6 +52,24 @@ Copy `main.js`, `manifest.json`, and `styles.css` to `.obsidian/plugins/shuffle-
 
 The language dropdown only shows `.json` files present in the `lang/` folder. On mobile, the plugin uses English only.
 
+## Contributing
+
+### Bug reports & feature requests
+Open an issue on the [GitHub repository](https://github.com/Mars-Marcelyn/Shuffle-Lab). Include your platform (desktop/mobile), Obsidian version, and steps to reproduce.
+
+### Translations
+See [Localization](#localization-desktop-only) above. Submit a pull request with your new `.json` file.
+
+### Code
+The plugin is a single-file JavaScript plugin (`main.js`) with no build step. To get started:
+
+1. Clone the repo and open in your editor.
+2. Make changes to `main.js`, `styles.css`, or `lang/*.json`.
+3. Copy the files to your vault's `.obsidian/plugins/shuffle-lab/` folder.
+4. Reload Obsidian and test.
+
+Pull requests are welcome. Keep changes focused and rebased on the latest `main`.
+
 ## License
 
-MIT
\ No newline at end of file
+MIT