Skip to content

Commit 46bb0bf

Browse files
committed
Improve README
1 parent f11d2ab commit 46bb0bf

File tree

1 file changed

+39
-7
lines changed

1 file changed

+39
-7
lines changed

README.md

Lines changed: 39 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,41 @@
1-
# Sips.app
2-
![Sips Icon](Icon/Sips-macOS-128x128@2x.png)
1+
# Sips.app
32

4-
Sips is an app for batch conversion of images.
5-
It uses built-in macOS command-line tool `sips`
3+
![Sips Icon](Icon/Sips-macOS-128x128@2x.png)
64

7-
Sips.app is built with OMC 5.0 engine and ActionUI:
8-
https://github.com/abra-code/OMC/
9-
https://github.com/abra-code/ActionUI/
5+
A native macOS applet for batch image conversion and resizing. Wraps the built-in macOS `sips` command-line tool in a SwiftUI interface with real-time preview.
6+
7+
Built with **OMC 5.0** engine — [github.com/abra-code/OMC](https://github.com/abra-code/OMC/)
8+
UI rendered by **ActionUI**[github.com/abra-code/ActionUI](https://github.com/abra-code/ActionUI/)
9+
10+
## Features
11+
12+
- **Batch conversion** of multiple images in one go
13+
- **Drag & drop** files or folders onto the app to populate the file list
14+
- **Recursive folder scanning** for supported image types
15+
- **Real-time preview** of resize, rotation, and flip settings
16+
- **20+ output formats** dynamically queried from macOS `sips`
17+
- **5 resize modes**: Exact Pixels, Percentage, Width, Height, Longest Edge
18+
- **Rotation**: 0°, ±90°, ±180°, ±270°
19+
- **Flip**: Horizontal, Vertical, or None
20+
- **Quality control** for lossy formats (1–100)
21+
- **Compression options** for applicable formats (e.g. TIFF LZW/PackBits)
22+
- **File info** panel with image dimensions, file size, and dates
23+
- **Overwrite protection** — optionally skip existing output files
24+
25+
## Supported Formats
26+
27+
Output formats are discovered at launch from the system `sips` command. Typical formats include:
28+
29+
JPEG, PNG, TIFF, GIF, BMP, HEIC, HEICS, WebP, PSD, PDF, JPEG 2000, ICNS, AVIF, DNG, ICO, DDS, EXR, ASTC, KTX, PBM, PVR, TGA
30+
31+
## Requirements
32+
33+
- **macOS 14.6+**
34+
35+
## Usage
36+
37+
1. Launch `Sips.app` (or drop image files/folders onto it)
38+
2. Add images using the **+** button
39+
3. Select an image to see its preview and info
40+
4. Adjust resize mode, rotation, flip, output format, and quality
41+
5. Click **Convert** and pick a destination folder

0 commit comments

Comments
 (0)