https://github.com/dbrgn/miniaturo
A drop-in replacement for raw-thumbnailer.
https://github.com/dbrgn/miniaturo
raw raw-thumbnailer rust thumbnails
Last synced: 9 months ago
JSON representation
A drop-in replacement for raw-thumbnailer.
- Host: GitHub
- URL: https://github.com/dbrgn/miniaturo
- Owner: dbrgn
- License: gpl-3.0
- Created: 2021-01-17T23:41:40.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-01-07T04:54:33.000Z (over 2 years ago)
- Last Synced: 2025-01-12T10:42:20.689Z (over 1 year ago)
- Topics: raw, raw-thumbnailer, rust, thumbnails
- Language: Rust
- Homepage:
- Size: 46.9 KB
- Stars: 12
- Watchers: 4
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# miniaturo
A RAW image thumbnailer written in Rust.
This project is intended to be a drop-in replacement for the (mostly
unmaintained) [raw-thumbnailer] project.
> :warning: **Note:** Miniaturo requires libopenraw 0.3, which was released in
> December 2020. As of early 2021, this library version is not yet bundled with
> distros that don't follow rolling releases. In those cases you need to
> manually install libopenraw.
[raw-thumbnailer]: https://libopenraw.freedesktop.org/raw-thumbnailer/
## Requirements
For building:
- Rust
- gcc or clang
- pkg-config
- libopenraw 0.3
## Installing
Ideally, you get this project through a distribution package.
Alternatively, you can install through cargo from crates.io:
cargo install miniaturo
Or build it yourself:
cargo build --release
## Implementation notes
miniaturo uses [libopenraw] (0.3) to parse the RAW image and thus supports
all camera formats that libopenraw supports.
The loading, resizing and encoding of the thumbnail is done in pure Rust using
[image-rs].
[libopenraw]: https://libopenraw.freedesktop.org/
[image-rs]: https://github.com/image-rs/image
## Project name
The name of this project is the Esperanto word for "thumbnail".
## Tests
To run integration tests, first download the test images:
python3 tests/download-test-images.py
Then run tests:
cargo test
## License
This project is licensed under the GPLv3 or later.
Copyright (C) 2021—2023 Danilo Bargen
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .