Metadata-Version: 2.4
Name: phaios
Version: 0.1.1
Summary: Dedicated black-and-white RAW developer
Project-URL: Source, https://github.com/sdhdez/phaios
Project-URL: Bug Tracker, https://github.com/sdhdez/phaios/issues
Author-email: "Simon D. HERNANDEZ" <2230157+sdhdez@users.noreply.github.com>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
Keywords: black-and-white,darkroom,gui,photography,pyside6,raw
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
Requires-Python: >=3.12
Requires-Dist: imageio>=2.36
Requires-Dist: numpy>=2.0
Requires-Dist: phaios-core<0.2,>=0.1
Requires-Dist: pyside6>=6.9
Requires-Dist: rawpy>=0.27
Requires-Dist: tifffile>=2024.1
Description-Content-Type: text/markdown

# phaios

**φαιός** — *dusky grey* (Aristotle, *De Sensu*). A dedicated black-and-white RAW
developer for the desktop.

phaios converts colour RAW files (NEF, CR2/3, ARW, RAF, DNG) to monochrome using the
canonical B&W photographic techniques: standard luminance weights, channel mixing, and
coloured-filter simulation. The numerical pipeline is powered by the
[phaios-core](https://github.com/sdhdez/phaios-core) Rust extension.

[![CI](https://github.com/sdhdez/phaios/actions/workflows/ci.yml/badge.svg)](https://github.com/sdhdez/phaios/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/phaios)](https://pypi.org/project/phaios/)
[![Licence: GPL v3](https://img.shields.io/badge/Licence-GPLv3-blue.svg)](LICENSE)

## Quick start

```sh
pip install phaios
python -m phaios              # launch the desktop app
```

Requires Python 3.12+ and a supported platform (Linux x86-64, Windows x86-64,
macOS arm64).

## Documentation

- [Changelog](CHANGELOG.md) — version history and release notes
- [UI spec](docs/ui-spec.md) — component inventory derived from the canonical mockup
- [Mockup](docs/mockup.html) — canonical interactive UI reference (open in browser)
- [Design brief](docs/design-brief.md) — original brief for the UI design

## Development

```sh
git clone https://github.com/sdhdez/phaios.git
cd phaios
uv venv .phaios-env && source .phaios-env/bin/activate
uv pip install -r requirements-dev.txt
uv pip install -e .
pytest
```

## Licence

GNU General Public License v3 or later — see [LICENSE](LICENSE).
