Metadata-Version: 2.4
Name: litemm
Version: 0.1.12
Summary: Media Manager & Visualizer
Project-URL: Homepage, https://hspk.github.io/mm/
Project-URL: Source, https://github.com/HSPK/mm
Project-URL: Issues, https://github.com/HSPK/mm/issues
License-Expression: LicenseRef-PolyForm-Noncommercial-1.0.0
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: aiosqlite>=0.22.1
Requires-Dist: asyncpg>=0.30
Requires-Dist: click>=8.3.1
Requires-Dist: fastapi[standard]>=0.115
Requires-Dist: lunar-python>=1.4.8
Requires-Dist: numpy>=1.24
Requires-Dist: peewee-aio>=2.2.2
Requires-Dist: peewee-async>=1.2.1
Requires-Dist: peewee>=3.19.0
Requires-Dist: pillow-heif>=0.18
Requires-Dist: pillow>=10.0
Requires-Dist: pydantic>=2
Requires-Dist: pyyaml>=6.0
Requires-Dist: rawpy>=0.26.1
Requires-Dist: rich>=13.9
Provides-Extra: clip
Requires-Dist: open-clip-torch>=2.24; extra == 'clip'
Requires-Dist: pillow>=10.0; extra == 'clip'
Requires-Dist: torch>=2.0; extra == 'clip'
Description-Content-Type: text/markdown

# MM

MM is a local-first media library manager for photos, videos, and audio. It helps
you scan existing folders, import new files safely, organize media with tags and
albums, and browse everything from a web UI.

[Homepage and docs](https://hspk.github.io/mm/) · [PyPI](https://pypi.org/project/litemm/) · [Issues](https://github.com/HSPK/mm/issues)

[![PyPI](https://img.shields.io/pypi/v/litemm)](https://pypi.org/project/litemm/)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://python.org)
[![License](https://img.shields.io/badge/license-PolyForm%20Noncommercial%201.0.0-blue)](LICENSE)

## What you can do with MM

- Browse your local media collection in a web UI.
- Import photos and videos into predictable folders.
- Keep your original files untouched while indexing.
- Search and organize media with tags, albums, ratings, places, and dates.
- Start locally and move to a server-backed setup later if you need it.

## Install

Install the recommended media tools first:

macOS:

```bash
brew install exiftool ffmpeg
```

Ubuntu / Debian:

```bash
sudo apt install libimage-exiftool-perl ffmpeg
```

Then install MM:

```bash
pipx install litemm
```

## First run

Create a library for your media folder:

```bash
mm init ~/Photos
```

Start the web UI:

```bash
mm server
```

Open `http://localhost:8000` in your browser.

## Import new media

Copy new media into the library:

```bash
mm import ~/Downloads/Camera
```

If files changed inside the active library and MM should update its index:

```bash
mm db sync
```

## Learn more

The full documentation site includes:

- [Getting Started](https://hspk.github.io/mm/tutorials/getting-started/)
- [Import and Organize](https://hspk.github.io/mm/tutorials/import-and-organize/)
- [Web UI Guide](https://hspk.github.io/mm/tutorials/web-ui/)
- [Architecture notes](https://hspk.github.io/mm/architecture/overview/)
- [Developer setup](https://hspk.github.io/mm/development/setup/)

## Native iOS / macOS app

A SwiftUI client targeting iOS 17+ and macOS 14+ lives under [`ios/`](./ios).
It's a separate Swift codebase that talks to this server over HTTP and
shares no code with the web frontend (by design — native UI). See
[ios/README.md](./ios/README.md) for build instructions.

## License

MM is available under the [PolyForm Noncommercial License 1.0.0](LICENSE).
Commercial use requires separate permission.
