InfiniTimeOrg · ncartron · Mar 4, 2022 · Mar 3, 2022
diff --git a/docs/user-documentation/apps.md b/docs/user-documentation/apps.md
@@ -1,6 +1,9 @@
 # How to use InfiniTime apps
 
 ## Stopwatch
+
+![Stopwatch](./pictures/stopwatch.png)
+
 The stopwatch measures passed time in minutes, seconds and hundredths of seconds.
 
 When the stop watch is not running, the left button shows a stop symbol and resets the current time to zero. It is not clickable when the time is already zero.
@@ -13,11 +16,18 @@ The right button shows a pause symbol. Tapping it pauses the measurement (withou
 
 ## Music player
 
+![Music control](./pictures/music.png)
+
 ## Navigation directions
 
+![Navigation](./pictures/navigation.png)
+
 ## Steps
+
+![Steps](./pictures/steps.png)
+
 The steps screen shows the current number of steps in the middle and your current steps goal and trip count underneath.
-Around it is a circular meter that shows how much of your goal you already achived.
+Around it is a circular meter that shows how much of your goal you already achieved.
 
 The steps count is measured daily and will be reset at midnight.
 You can configure your step goal in the settings.
@@ -26,19 +36,25 @@ Your trip steps will not be reset at midnight.
 You can do this yourself by pressing the Reset button on the bottom of the screen.
 
 ## Heart-rate
+
+![Heart-rate](./pictures/hr.png)
+
 The heart rate app measures your heart rate using the sensor on the backside of the watch. When you activate the heart rate measurement, a fast blinking green light comes out of .
 
 At the beginning, the measurement is turned off.
-The screens shows a grey "000" and "stopped" underneath.
+The screen shows a grey "000" and "stopped" underneath.
 Press the "Start"-button at the bottom of the screen activate the measurement.
 After starting the measurement, the measurement should become green and the text underneath should be "Not enough data, please wait ...". 
-Ater a short while (~ 10 seconds), the text should be "Measuring ..." and on the top there should be a number that is your measured heart rate.
+After a short while (~ 10 seconds), the text should be "Measuring ..." and on the top there should be a number that is your measured heart rate.
 
 To stop the measurement, press the button at the bottom, which should now be labeled with "Stop".
 
 *Keep in mind that InfiniTime and the PineTime watch are no medical devices. The measured number is not guaranteed to be your actual heart rate. See this feature more as a toy.*
 
 ## Timer
+
+![Timer](./pictures/timer.png)
+
 The Timer app lets you set a timer after which your watch will vibrate once and wake up if it was asleep.
 
 The screen shows two digits for minutes and two digits for seconds, each with a button labeled "+" above and a button labeled "-" beneath.
@@ -49,13 +65,19 @@ Tapping it activates the timer and changes the play button to a pause button.
 Tapping the pause button pauses the timer.
 
 ## Paint
+
+![InfiniPaint](./pictures/paint.png)
+
 InfiniPaint is an app that lets you draw using the touchscreen.
 
 At the start, the app will show a black screen.
 Touching the screen will let you draw white pixels.
 If you hold a touch for long enough, there will be a vibration and you will have a new color.
 
 ## Pong
+
+![Paddle](./pictures/paddle.png)
+
 Pong is a little game that you can play.
 In the middle of the screen is a little ball that will bounce of the walls except the left one.
 At the left side there is a bar that will bounce the ball.
@@ -65,6 +87,9 @@ Your points are shown at the top of the screen.
 Try to get as many points as possible.
 
 ## 2048
+
+![2048](./pictures/twos.png)
+
 2048 is a puzzle game you can play.
 At the start, you can see a four by four grid of cells and your score at the top, which should be zero.
 Some of the cells will be filled with numbers that are powers of two.
@@ -74,10 +99,16 @@ All numbers on the grid will then move as far in this direction as possible.
 When two numbers with the same values collide, they will be added to a single cell.
 
 ## Accelerometer
+
+![Accelerometer](./pictures/accelerometer.png)
+
 The accelerometer visualizes the accelerations along the x, y and z axis that are measured by the motion sensor of the watch.
 In the bottom left corner, it also shows your current step count.
 
 ## Metronome
+
+![Metronome](./pictures/metronome.png)
+
 The metronome app lets you have a vibrating metronome on your wrist.
 The metronome vibrates on each beat.
 The first beat of each bar is stronger than the other ones.
@@ -91,6 +122,9 @@ The right button shows a play sign if the metronome is paused and a pause sign i
 Use it to start or pause the metronome.
 
 ## Alarm
+
+![Alarm](./pictures/alarm.png)
+
 The alarm app lets you set an alarm to wake you up in the morning (or whenever).
 
 The screen contains two digits for the hour on the left and two digits for the minutes on the right.

diff --git a/docs/user-documentation/index.md b/docs/user-documentation/index.md
@@ -52,7 +52,8 @@ time directly from the watch.
 This can be done from the Settings menu, then "Set date" and "Set time"
 respectively:
 
-(insert here pics of IT)
+![Set date manually](./pictures/set_date.png)
+![Set time manually](./pictures/set_time.png)
 
 #### Using any Chromium-based web-browser
 
@@ -119,7 +120,9 @@ There are 2 other watchfaces:
 - Analog 
 - PineTimeStyle
 
-(Add pics from the watchfaces)
+![Digital watchface](./pictures/watchface_digital.png)
+![Analog watchface](./pictures/watchface_analog.png)
+![PTS watchface](./pictures/watchface_pts.png)
 
 #### Notification screen
 
@@ -131,7 +134,7 @@ To come back to the watchface, press the left button.
 It is currently not possible to discard notifications, unless you restart
 InfiniTime (long press on the button for ~8 seconds).
 
-(Insert notification pics)
+![Notification](./pictures/notifications.png)
 
 #### Apps drawer
 
@@ -155,14 +158,14 @@ Page 2:
 - Metronome
 - Alarm
 
-(Add pics of the 2 pages of apps)
-
-**(Note to JF: does it make sense to have a subsection for each app, with
-screenshots and more details?)**
+![App menu 1](./pictures/app_menu_1.png)
+![App menu 2](./pictures/app_menu_2.png)
 
 #### Quick settings
 
-When swiping right, you get access to 4 icons - from top left to bottom right:
+When swiping right, you get access to 4 icons :
+
+![Quick settings](./pictures/quick_settings.png)
 
 - brightness level: pressing it will cycle between 3 levels (low/medium/high)
 - torch: 
@@ -176,8 +179,15 @@ When swiping right, you get access to 4 icons - from top left to bottom right:
   - taping it enables it: the icon becomes grey, and the watch will not vibrate
     when receiving notifications)
 - settings: access to InfiniTime settings
-  - Display timeout (in seconds)
-  - Wake up: how to wake up the watch
+
+The following settings are available:
+
+![Settings 1](./pictures/settings_menu_1.png)
+![Settings 2](./pictures/settings_menu_2.png)
+![Settings 3](./pictures/settings_menu_3.png)
+
+- Display timeout (in seconds)
+- Wake up: how to wake up the watch
     - nothing selected means only the left button wakes up the watch
     - single tap: tap one time on the screen to wake up the watch
     - double tap: tap two times to wake it up
@@ -188,7 +198,8 @@ When swiping right, you get access to 4 icons - from top left to bottom right:
 - Set date: allows manually setting date
 - Set time: allows manually setting time
 - Battery: displays battery level and voltage
-- PTS Colors: allows changing colors for the PineTimeStyle watchface
+- Chimes: Emit a small vibration every hour or half-hour
+- Shake calibration: calibration the sensitivity of the "shake to wake" functionality
 - Firmware: displays information about the InfiniTime version
 - About: displays information about InfiniTime, the Bootloader, uptime, etc
 

diff --git a/docs/user-documentation/pictures/about_1.png b/docs/user-documentation/pictures/about_1.png
diff --git a/docs/user-documentation/pictures/about_2.png b/docs/user-documentation/pictures/about_2.png
diff --git a/docs/user-documentation/pictures/about_3.png b/docs/user-documentation/pictures/about_3.png
diff --git a/docs/user-documentation/pictures/about_4.png b/docs/user-documentation/pictures/about_4.png
diff --git a/docs/user-documentation/pictures/accelerometer.png b/docs/user-documentation/pictures/accelerometer.png
diff --git a/docs/user-documentation/pictures/alarm.png b/docs/user-documentation/pictures/alarm.png
diff --git a/docs/user-documentation/pictures/app_menu_1.png b/docs/user-documentation/pictures/app_menu_1.png
diff --git a/docs/user-documentation/pictures/app_menu_2.png b/docs/user-documentation/pictures/app_menu_2.png
diff --git a/docs/user-documentation/pictures/battery.png b/docs/user-documentation/pictures/battery.png
diff --git a/docs/user-documentation/pictures/chimes.png b/docs/user-documentation/pictures/chimes.png
diff --git a/docs/user-documentation/pictures/crop.sh b/docs/user-documentation/pictures/crop.sh
@@ -0,0 +1,6 @@
+#!/bin/bash
+#convert
+for image in *.png; do
+        convert  "$image" -crop 240x240+0+29  "$image"
+done
+exit 0 
diff --git a/docs/user-documentation/pictures/display_timeout.png b/docs/user-documentation/pictures/display_timeout.png
diff --git a/docs/user-documentation/pictures/firmware_validation_1.png b/docs/user-documentation/pictures/firmware_validation_1.png
diff --git a/docs/user-documentation/pictures/flashlight_1.png b/docs/user-documentation/pictures/flashlight_1.png
diff --git a/docs/user-documentation/pictures/flashlight_2.png b/docs/user-documentation/pictures/flashlight_2.png
diff --git a/docs/user-documentation/pictures/hr.png b/docs/user-documentation/pictures/hr.png
diff --git a/docs/user-documentation/pictures/metronome.png b/docs/user-documentation/pictures/metronome.png
diff --git a/docs/user-documentation/pictures/music.png b/docs/user-documentation/pictures/music.png
diff --git a/docs/user-documentation/pictures/navigation.png b/docs/user-documentation/pictures/navigation.png
diff --git a/docs/user-documentation/pictures/notifications.png b/docs/user-documentation/pictures/notifications.png
diff --git a/docs/user-documentation/pictures/paddle.png b/docs/user-documentation/pictures/paddle.png
diff --git a/docs/user-documentation/pictures/paint.png b/docs/user-documentation/pictures/paint.png
diff --git a/docs/user-documentation/pictures/quick_settings.png b/docs/user-documentation/pictures/quick_settings.png
diff --git a/docs/user-documentation/pictures/quick_settings_notif_off.png b/docs/user-documentation/pictures/quick_settings_notif_off.png
diff --git a/docs/user-documentation/pictures/set_date.png b/docs/user-documentation/pictures/set_date.png
diff --git a/docs/user-documentation/pictures/set_time.png b/docs/user-documentation/pictures/set_time.png
diff --git a/docs/user-documentation/pictures/setting_watchface.png b/docs/user-documentation/pictures/setting_watchface.png
diff --git a/docs/user-documentation/pictures/settings_menu_1.png b/docs/user-documentation/pictures/settings_menu_1.png
diff --git a/docs/user-documentation/pictures/settings_menu_2.png b/docs/user-documentation/pictures/settings_menu_2.png
diff --git a/docs/user-documentation/pictures/settings_menu_3.png b/docs/user-documentation/pictures/settings_menu_3.png
diff --git a/docs/user-documentation/pictures/shake_calib.png b/docs/user-documentation/pictures/shake_calib.png
diff --git a/docs/user-documentation/pictures/step_goal.png b/docs/user-documentation/pictures/step_goal.png
diff --git a/docs/user-documentation/pictures/steps.png b/docs/user-documentation/pictures/steps.png
diff --git a/docs/user-documentation/pictures/stopwatch.png b/docs/user-documentation/pictures/stopwatch.png
diff --git a/docs/user-documentation/pictures/time_format.png b/docs/user-documentation/pictures/time_format.png
diff --git a/docs/user-documentation/pictures/timer.png b/docs/user-documentation/pictures/timer.png
diff --git a/docs/user-documentation/pictures/twos.png b/docs/user-documentation/pictures/twos.png
diff --git a/docs/user-documentation/pictures/wake_up.png b/docs/user-documentation/pictures/wake_up.png
diff --git a/docs/user-documentation/pictures/watchface_analog.png b/docs/user-documentation/pictures/watchface_analog.png
diff --git a/docs/user-documentation/pictures/watchface_digital.png b/docs/user-documentation/pictures/watchface_digital.png
diff --git a/docs/user-documentation/pictures/watchface_pts.png b/docs/user-documentation/pictures/watchface_pts.png