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 · PyPI · Issues

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:

brew install exiftool ffmpeg

Ubuntu / Debian:

sudo apt install libimage-exiftool-perl ffmpeg

Then install MM:

pipx install litemm

First run

Create a library for your media folder:

mm init ~/Photos

Start the web UI:

mm server

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

Import new media

Copy new media into the library:

mm import ~/Downloads/Camera

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

mm db sync

Learn more

The full documentation site includes:

Native iOS / macOS app

A SwiftUI client targeting iOS 17+ and macOS 14+ lives under 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 for build instructions.

License

MM is available under the PolyForm Noncommercial License 1.0.0. Commercial use requires separate permission.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

litemm-0.1.16.tar.gz (1.1 MB view details)

Uploaded Jul 10, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

litemm-0.1.16-py3-none-any.whl (621.1 kB view details)

Uploaded Jul 10, 2026 Python 3

File details

Details for the file litemm-0.1.16.tar.gz.

File metadata

Download URL: litemm-0.1.16.tar.gz
Upload date: Jul 10, 2026
Size: 1.1 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for litemm-0.1.16.tar.gz
Algorithm	Hash digest
SHA256	`d15ca5af338d1332228a56a6f29dfaa21568532e40284148a23180421ba1da16`
MD5	`bb0866fc6ace80149f3f026f4b9f9815`
BLAKE2b-256	`f49c867274b6d7284758ea28585789001def46b45ccfc61792ef209f84bf97c9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for litemm-0.1.16.tar.gz:

Publisher: release.yml on HSPK/mm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: litemm-0.1.16.tar.gz
- Subject digest: d15ca5af338d1332228a56a6f29dfaa21568532e40284148a23180421ba1da16
- Sigstore transparency entry: 2133745839
- Sigstore integration time: Jul 10, 2026
Source repository:
- Permalink: HSPK/mm@0ac556f7871c3234f7c93ecaf6a3eae400807282
- Branch / Tag: refs/tags/v0.1.16
- Owner: https://github.com/HSPK
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@0ac556f7871c3234f7c93ecaf6a3eae400807282
- Trigger Event: release