# caesium-image-compressor

**Repository Path**: syecao/caesium-image-compressor

## Basic Information

- **Project Name**: caesium-image-compressor
- **Description**: Caesium is an image compression software that helps you store, send and share digital pictures, supporting JPG, PNG and WebP formats.
You can quickly reduce the file size (and resolution, if you want)
- **Primary Language**: C
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-05-10
- **Last Updated**: 2023-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Caesium Image Compressor

###### v2.4.0

![caesium_screenshot_20220915](https://user-images.githubusercontent.com/12133996/190349051-6baebec3-9937-4047-8670-fb025c6c4869.PNG)

----------
### What is it for
Caesium is an image compression software that helps you store, send and share digital pictures, supporting JPG, PNG and WebP formats.  
You can quickly reduce the file size (and resolution, if you want) by preserving the overall quality of the image.

### Supported Platforms
- **Windows**: 8.1+ (use old version v1.x for Windows 7 - [link](https://www.fosshub.com/Caesium-Image-Compressor-old.html))
- **MacOS**: 10.15+
- **Linux**: tested on Ubuntu 22.04 and Manjaro

Note: only 64bit versions are supported

### Installation
Head to the [releases' page](https://github.com/Lymphatus/caesium-image-compressor/releases) for the available downloads.
- **Windows**: installer and portable versions are available
- **MacOS**: DMG package
- **Linux**: compile the source code yourself, or download binary from [third-party build](https://github.com/larygwil/caesium-image-compressor/releases)

### Troubleshooting and/or feature request
Please open an [issue](https://github.com/Lymphatus/caesium-image-compressor/issues).

### Build from source
##### Requirements
- [Rust](https://www.rust-lang.org/tools/install): required to compile [libcaesium](https://github.com/Lymphatus/libcaesium). Make sure you have `cargo` executable on you `$PATH`
- [Qt6 SDK](https://www.qt.io/download/): binaries are built on 6.4.2 (open source)
- [libssh](https://www.libssh.org/): macOS only

#### Build
##### Step 1
You need to configure CMake first and the command is slightly different for all the platforms:
Change the path in variables with the correct directories of the requirements.
###### Windows
```
cmake -B build_dir -DCMAKE_PREFIX_PATH=/path/to/Qt/version -DCMAKE_BUILD_TYPE=Release -G "MinGW Makefiles"
```
###### MacOS
```
cmake -B build_dir -DCMAKE_PREFIX_PATH=/path/to/Qt/version/macos -DLIBSSH_INCLUDE_DIR=/libssh/dir/include -DCMAKE_BUILD_TYPE=Release
```
###### Linux
Make sure you have all the requirements installed with you own package manager
```
cmake -B build_dir -DCMAKE_PREFIX_PATH=/path/to/Qt/version/gcc_64 -DCMAKE_BUILD_TYPE=Release
```
##### Step 2
Then you can build with
```
cmake --build build_dir --config Release --target caesium_image_compressor
```

### Languages and translations
The 1.0 version of Caesium had a lot of community made translations, but this 2.0 release has a whole new set of strings and no old translations can be used anymore.   
Caesium 2.0 is currently available in:
- 🇺🇸 English ![100%](https://progress-bar.dev/100)
- 🇮🇹 Italian ![100%](https://progress-bar.dev/100)
- 🇫🇷 French ![83%](https://progress-bar.dev/83)
- 🇯🇵 Japanese ![87%](https://progress-bar.dev/87)
- 🇨🇳 Simplified Chinese ![82%](https://progress-bar.dev/82)
- 🇪🇸 Spanish ![89%](https://progress-bar.dev/89)
- 🇪🇬 Arabic (Egypt) ![83%](https://progress-bar.dev/83)
- 🇩🇪 German ![95%](https://progress-bar.dev/95)
- 🇷🇺 Russian ![100%](https://progress-bar.dev/100)
- 🇹🇷 Turkish ![84%](https://progress-bar.dev/84)
- 🇬🇷 Greek ![100%](https://progress-bar.dev/100)
- 🇧🇷 Brazilian Portuguese ![86%](https://progress-bar.dev/86)
- 🇮🇩 Indonesian ![100%](https://progress-bar.dev/100)
- 🇹🇼 Traditional Chinese (TW) ![100%](https://progress-bar.dev/100)
- 🇸🇰 Slovak ![80%](https://progress-bar.dev/80)

#### How to contribute with your translation
You can help translate by opening the `resources/i18n/caesium_en_US.ts` with QtLinguist or any XML editor. Rename it to your language (e.g. `caesium_it_IT.ts`) and translate all the sentences. Then you can start a pull request with your translated file.  
See [this pull request](https://github.com/Lymphatus/caesium-image-compressor/pull/106) as an example.
Thanks to all the people who contributed.