Images, distributed over Nostr.
A lightweight PHP image-publishing app that signs and distributes images across Nostr relays without permanently storing image binaries on the origin server.
Website · API · JavaScript SDK · Windows Setup · Türkçe
Most image hosts keep files on their own disks. IMGTR processes supported images client-side, signs Nostr manifests and chunks with ephemeral keys, and publishes those events to multiple relays. The origin keeps account and image metadata in MySQL/MariaDB, then verifies relay content when images are read.
Open source does not mean encrypted storage. Nostr relays can be public, and independently retained copies may remain available.
- Nostr-native: signed manifests, event-based chunks and relay replication.
- Verification: independently check event IDs, content hashes, reconstructed size and relay acknowledgements.
- Zero permanent image binary storage on the origin.
- Built for ordinary hosting: PHP, MySQL/MariaDB, Apache; no Docker or background Node server required.
- Full web interface: accounts, albums, collections, admin tools, translated UI.
- Developer-friendly: REST API v1, OpenAPI 3.1, Node.js SDK/CLI and ShareX bridge.
Browser / SDK
│ Prepare image, sign manifest & chunks
▼
Public Nostr relays ◄── signed publications
│
▼
IMGTR PHP API ──────── MySQL / MariaDB
│ users, metadata, albums
▼
Verified viewer / image reconstruction
See Architecture.
Requirements: PHP 8.1+, Apache/mod_rewrite, MySQL/MariaDB, HTTPS, PDO MySQL, cURL, OpenSSL, mbstring and fileinfo. Node.js 20+ is required for SDK/CLI usage only.
cp includes/config.example.php includes/config.php
# Enter your own database credentials and site URL.Important: IMGTR's public code currently comes from an existing production installation. The complete fresh-install SQL bootstrap is not yet available. SQL scripts under updates/ are incremental changes, not a full installation schema. Do not deploy to an empty database expecting a complete installer. See Self-hosting notes.
cd sdk/js
npm install
npm test
npm linkimport { ImgtrClient } from '@imgtr/sdk';
const client = new ImgtrClient({ apiKey: process.env.IMGTR_API_KEY });
const image = await client.upload('./photo.jpg');
console.log(image.direct_url);Read the SDK documentation or API specification.
- Relay-published content is not encrypted by default; signatures prove event provenance, not confidentiality.
- Public relay operators or other users may mirror content, regardless of deletion requests.
- This source release includes no live database, user media, production configuration or deploy credentials.
- Forks and pull requests do not have access to the production hosting environment.
For responsible disclosure, see SECURITY.md.
See CONTRIBUTING.md for guidelines. Translations, accessibility, relay compatibility, tests and a reproducible fresh-install database schema are welcome.
IMGTR application code is licensed under MIT; sdk/js/ retains its own MIT license. Trademark and end-user uploaded content rights are separate from the software license.