You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+21-23Lines changed: 21 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,32 +12,42 @@ A typical camera roll of **10 GB** can be reduced to around **1 GB** using WebP
12
12
13
13
## Features
14
14
15
+
### Photo Viewer (Main Screen)
16
+
- Browse any folder on your device as a photo gallery
17
+
- Navigate subfolders with a visual breadcrumb bar
18
+
- Folder image counts shown at a glance
19
+
- Full-screen image viewer with swipe between photos
20
+
-**Delete** photos directly from the viewer (with confirmation)
21
+
-**Rotate** photos 90° (rotation is saved to file)
22
+
- Folder listing cached for instant navigation on revisits
23
+
- Dark mode support
24
+
25
+
### Photo Compressor (Settings Screen)
15
26
- Converts JPG/JPEG and PNG files to WebP format
16
-
- PNG images are compressed losslessly
17
27
- JPG images compressed with configurable quality (default 65)
18
28
- Max resolution cap (default 1280px) to resize oversized photos
19
29
- Preserves EXIF rotation data
20
-
- Skips files already in WebP format
21
30
- Skips files already compressed (idempotent)
22
31
- Deletes originals only after successful compression
23
-
-Moves compressed files from a temp folder to a final destination
32
+
-Temp files stored in app-internal cache (hidden from file managers)
24
33
- Runs as a foreground service with notification (won't be killed mid-compression)
25
-
- Remembers your folder settings between sessions
34
+
- Remembers all folder settings between sessions
26
35
27
36
## How it works
28
37
29
-
1.**Select three folders** using Android's folder picker:
30
-
-**Source** — folder containing photos to compress, tipically camera folder (e.g. `DCIM/Camera`)
31
-
-**Temp** — where compressed WebP files are written first (just create one somewhere)
32
-
-**Final** — where files are moved after successful compression (your compressed gallery folder)
38
+
1.**Set a gallery root folder** — choose any folder to browse as a photo gallery (this is the main screen)
33
39
34
-
2.**Adjust settings** (optional):
40
+
2.**In Settings, select compression folders:**
41
+
-**Source** — folder containing photos to compress, typically camera folder (e.g. `DCIM/Camera`)
42
+
-**Final** — where compressed files are moved after successful compression
43
+
44
+
3.**Adjust settings** (optional):
35
45
- Quality: 1–100 (default 65 — good balance of size and quality)
36
46
- Max resolution: largest dimension in pixels (default 1280)
37
47
38
-
3.**Tap Start** — the app processes all images in the background, showing progress in a notification.
48
+
4.**Tap Start** — the app processes all images in the background, showing progress in a notification.
39
49
40
-
4.**Originals are deleted** only after the compressed file is successfully written, so you never lose photos.
50
+
5.**Originals are deleted** only after the compressed file is successfully written, so you never lose photos.
41
51
42
52
## Install
43
53
@@ -47,18 +57,6 @@ Download the latest APK from the [Releases](https://github.com/adegard/ImageComp
47
57
48
58
The app needs access to your photo folders. When you tap "Select", Android will ask you to grant access to that directory. This is normal — the app uses Android's Storage Access Framework (SAF) and never reads anything outside the folders you choose.
49
59
50
-
## Recommended Gallery App
51
-
52
-
For browsing WebP files from your compressed folder on Android, use **Gallery** from [Simple Mobile Tools](https://github.com/SimpleMobileTools/Simple-Gallery)
0 commit comments