Skip to content

Releases

Libregram v1.6.0 — Your gallery, ready for Docker

Choose a tag to compare

@adlererik adlererik released this 20 Oct 11:17

Libregram v1.6.0 — Your gallery, ready for Docker

By Erik Adler · October 20, 2026 · MIT license.

Libregram is a free, open-source Instagram alternative for sharing photos and videos without a walled garden or media lock-in. Keep your originals and database, share a mixed-media compilation with one short URL, and enjoy presentations through compatible AirPlay or Google Cast receivers. Friends and family can open public sharing links without creating an account.

Start with almost no setup

Download compose.yaml from this release into an empty folder. With Docker and Compose installed:

docker compose up -d
docker compose exec libregram node deploy/docker/manage.mjs credentials

Open http://localhost:3000, sign in with your privately displayed generated login, and upload your first media. No Node/FFmpeg installation, Cloudflare account, API key or shared default password is required. Native AMD64/ARM64 images are published as ghcr.io/adlererik/libregram:1.6.0; see the Docker guide for prerequisites, LAN/HTTPS access, full-volume backup/restore, recovery and upgrades.

The default Compose binding is local to the computer. Public hosting, a domain and HTTPS need your own setup. The private data volume survives container replacement. Do not delete the volume when upgrading.

New since v1.5.0

  • Docker distribution: a non-root image, one-file Compose startup, unique first-run credentials, persistent database/media/runtime state, health reporting, explicit login recovery, and a database backup before changed-schema application. Published builds use audited source and an allowlisted context.
  • Age tracking in Settings: enter a birthday, preview today's age, and enable/disable historical age labels. Calendar calculations are consistent in feed/theater and apply after saving without a rebuild. Fresh installs contain no preset birthday.
  • Readable mobile captions: four-line previews expand with a small centered chevron. Preserve line breaks and wrap long words; the control appears only for overflowing captions.
  • Optional handset shortcut: off by default. Configure its URL and a 4–12 digit PIN in Settings. A themed touch keypad with neutral wording requires a fresh PIN on every use, with server-side attempt limits and a private salted hash. It does not include or modify a separate phone app, and direct destination links retain that app's own security.
  • Updated handbook and beginner documentation: Docker and direct-source installation paths, backup locations, phone settings, age settings, and practical sharing/casting limits. All nine existing README image elements remain.

The existing gallery, all-media thumbnail wall/year jumps, editable carousels, soundtracks, five themes, individual Favorites, one-URL compilations, direct media links, TV playback, persistent visitor history, country flags/estimated city maps, and combined region filters remain available. See the complete feature guide.

Upgrade and compatibility

v1.6.0 introduces no database columns. Direct installations retain their existing media, accounts, login mode, hostname and sharing links. Back up private data, install the locked dependencies, and rebuild before restarting. Preserve .runtime/age-tracking.json and .runtime/phone-shortcut.json when present. The current locked Prisma CLI and TSX runner move from development to runtime dependencies for container startup and Instagram export import; dependency versions are unchanged. Historical schema updates from v1.2.0/v1.4.0 still apply to older installations. Never reset a populated database or accept data loss automatically.

Docker is an additional installation method, not an automatic conversion of an existing source installation. Follow the source upgrade reference or container upgrade instructions for the method you use.

Privacy, defaults and costs

Source archives and images contain no maintainer passwords, session/tunnel tokens, private environment, preset birthday, personal uploaded media, populated gallery database, visitor records, private backups or operator phone proxy. Existing public README screenshot links are intentionally preserved. Runtime credentials are generated only when a new installation starts and remain in its private volume.

Default authentication remains CMS username/password. Local GeoIP remains the default; optional IP2Location.io lookup and Cloudflare identity login require the owner's configuration. Gallery/media/sharing URLs are public by design. IP map pins are estimates, not GPS. Browsers can require a tap for sound; AirPlay presentation progression can depend on the sender page remaining active.

The software and shortcut/sharing features require no paid API or CMS subscription. Your server, storage, electricity, Internet, domain and receiver hardware remain your own costs. Docker Desktop and optional providers have their own terms.

Downloads

  • libregram-v1.6.0-source.zip and libregram-v1.6.0-source.tar.gz: audited Git source, lockfile, schema, documentation, empty upload placeholder and Docker build files.
  • compose.yaml: start the prebuilt image without cloning or building.
  • SHA256SUMS: source and deployment-file checksums.
  • Container image/digests: see the release's container details and GHCR package.

Build and publication evidence is recorded in Verification. Existing device/receiver confirmations remain historical evidence; this release does not claim every browser allows audible autoplay or that all TVs support both casting systems.

Published container details

Public image: ghcr.io/adlererik/libregram:1.6.0 (Linux AMD64 and ARM64). Both native builds and the multi-platform manifest job completed successfully. Registry manifests/configuration were retrieved anonymously and match this release commit. See container-digests.json for immutable digests.

Libregram v1.5.0 — Share freely, without the walled garden

Choose a tag to compare

@adlererik adlererik released this 14 Oct 00:53

Libregram v1.5.0 — Share freely, without the walled garden

By Erik Adler · October 14, 2026 · MIT license.

Libregram is a free, open-source Instagram alternative focused on sharing photos and videos without media lock-in. Host it yourself, keep your original files and portable SQLite database, and move your collection whenever you choose.

Share a whole story

  • Select photos and videos, arrange Favorites, and send a continuous compilation with one compact URL.
  • Send individual media through a copied link, email, text message, or a supported native share sheet. Compatible messaging apps show thumbnail previews.
  • Recipients open links without an account or app; presentations offer timed photos, full videos, repeat, seeking, and fullscreen where supported.
  • Enjoy your media on compatible TVs through AirPlay or Google Cast, with receiver and browser requirements described in the feature guide.

New in this release

  • Libregram branding throughout the default gallery title, login, administration, documentation, package, GitHub repository, launch command, service templates, and source downloads.
  • Visitor filters for Western Europe, Scandinavia (Denmark, Norway, Sweden, Finland, and Iceland), North America, South America, Asia, and World. Combine regions; counts, devices, history, and pagination follow the choice. This changes the display without blocking traffic or deleting records.
  • Region choices remembered per administrator browser, and browser tabs that use the Title saved in Header text settings.
  • All nine existing README screenshots preserved. Updated beginner, feature, administration, migration, and operating guides.

Existing installations

Use the rename and upgrade guide. Existing media, accounts, sessions, Favorites, shared links, visitor history, and optional identity configuration are preserved. Custom gallery titles stay intact. Legacy launcher/environment identifiers are supported for compatibility; new installations use ./libregram and Libregram service names.

No new database columns are introduced in v1.5.0. The default title changes for new databases; upgrades from earlier versions still need the previously documented additive schema updates. Back up private data before upgrading. Never reset a populated database.

Install and costs

Follow the beginner guide. Fresh setup uses CMS username/password login, an empty database, and local GeoIP lookup. Cloudflare and IP2Location.io are optional. The MIT-licensed software requires no CMS subscription, paid sharing API, link shortener, or casting registration. Your server, storage, electricity, Internet, domain, and receiver hardware are your own costs.

The gallery and share links are public; administration and visitor IPs require authentication. IP coordinates are approximate city/network estimates, and visible stay is an estimate. Browsers may require a tap for sound. AirPlay progression can depend on the sender page remaining active. Libregram is independent of Instagram/Meta.

Downloads and build evidence

libregram-v1.5.0-source.zip, libregram-v1.5.0-source.tar.gz, and SHA256SUMS are created from audited Git source. They contain no private media, credentials, populated databases, visitor records, installation configuration, backups, runtime binaries, dependencies, or compiled builds. The README screenshot references remain included.

Production builds and TypeScript checks passed locally and in isolated Debian staging. This release does not claim new browser, fresh-install, or physical receiver test results.

Libregram v1.4.0 — Visitor cities, maps and visible stay

Choose a tag to compare

@adlererik adlererik released this 12 Oct 17:25

Libregram v1.4.0 — Visitor cities, maps, and visible stay

By Erik Adler · MIT license.

What is new

  • Optional free IP2Location.io city estimates for IPv4 and IPv6, with country flags, 24-hour caching, a 900/day request cap, and local fallback.
  • Small Estimated location links open Apple Maps on Apple administrator devices and Google Maps elsewhere. IP locations are estimates, never someone’s exact GPS position.
  • Visible stay estimates time while the page is visible. Updates arrive about every 20 seconds and on leaving; historical durations remain unknown.
  • Refresh older locations one history page at a time. Keep history until manual deletion.
  • Exclude local-network and recognized owner visits; correctly recognize encoded administrator cookies.
  • Updated setup, privacy, feature, upgrade, and operation guides. All nine current README screenshot links are preserved.

Free setup and privacy

New installations still use ordinary CMS username/password login and local GeoIP. Cloudflare and an IP lookup account are not required.

To enable the free keyless API, set VISITOR_GEO_PROVIDER="ip2location" in private .env.local and restart. No account/card is needed. An optional free-account key stays server-side. The provider’s free service has no overage charges; the application falls back locally at its cap or when the API is unavailable. Ordinary server/Internet costs remain yours. API instructions, current pricing, privacy, and limitations.

When enabled, outside public IPs are sent to IP2Location.io. Required visible credit and provider-aware privacy disclosure are included. No GPS permission is requested. Maps and duration are estimates and can be inaccurate or unavailable.

Upgrade safely

Back up SQLite, uploads, private environment files, runtime settings, and sharing links first. Record your previous source revision. After updating to this tag, install locked dependencies, apply pnpm db:push, then rebuild/restart. New Visit columns are optional or defaulted; no reset or re-import is needed. Never use --accept-data-loss. Credentials, login mode, media, visitor history, and sharing links remain intact.

Beginner installation · Upgrade guide · All features

Source-only downloads

ZIP, tarball, and SHA256SUMS are generated from audited Git source. No passwords, tokens, private account settings, personal media files, populated databases, visitor records, private backups, dependencies/runtime binaries, or compiled builds are included. The intentionally published README image links remain.

Existing one-link photo/video compilations, direct sharing, Google Cast/AirPlay, Favorites, carousels, soundtracks, themes, and CMS tools remain available. Production builds and TypeScript checks passed; no new device interaction or IP-city accuracy tests were performed.

Libregram v1.3.0 — One link to share your memories

Choose a tag to compare

@adlererik adlererik released this 10 Oct 21:32

Libregram v1.3.0 — One link to share your memories

By Erik Adler · October 10, 2026 · MIT-licensed source release.

A self-hosted Instagram replacement for your personal photos, videos, and memories. Keep the originals on your own server, curate them in a built-in CMS, and share a mixed photo/video presentation with one short URL.

Why Erik built this

Erik wanted ownership of his memories beyond Instagram's walled garden. In his experience, Pixelfed was too limited and clunky for the workflow he wanted. Libregram combines a focused gallery, original-file preservation, fast browsing, easy family sharing, and TV playback. These are concrete reasons it suits his workflow better; it does not claim universal superiority over every gallery or provide a full social network.

The existing project screenshots remain in the README. Fresh installations start empty with their own media and unique credentials.

New since v1.2.0

  • One short URL for a compilation: save individual photos/videos in Favorites, arrange their order, choose photo duration and Repeat, and send a presentation link. Recipients need no account; photos advance and videos play to completion.
  • Direct media links: a paper-plane Send to icon shares the selected photo/video. Copy link, Email, Message, and native device sharing are offered where supported.
  • Recipient controls and previews: native video scrubbing, play/pause, speed, fullscreen where supported, presentation seeking, and first-item thumbnail metadata for compatible messaging apps. Sound is requested by default, with a browser-required Tap for sound/Play fallback.
  • Discreet gallery controls: small top-right Cast/Send/Favorite/Volume icons, 37.5%-opacity backgrounds, matching tappable carousel counter, and a three-second inactivity fade. Movement, touch, or keyboard focus reveals controls; open menus remain available.
  • Organized administration: separate top-right lock/logout; square-plus for A new chapter uploads; far-right cogwheel for visitor history, header settings, login choices, and the handbook.
  • Persistent visitor history: public IPs, country flags, approximate city, OS/device/browser, and paginated history. Local and recognized owner browser/IP visits are excluded. Delete one record or all history manually; there is no scheduled pruning.
  • Simple default login: fresh setup explicitly uses CMS username/password with unique generated credentials and local recovery. No Cloudflare account or biometric device is needed.
  • Optional owner identity login: owners who configure Cloudflare Access can skip the CMS password form. Signed JWT verification checks the configured issuer, audience, exact owner email, hostname, and expiry. Google or Cloudflare account sign-in, Apple-related social login, and device passkeys depend on provider configuration and device support.
  • Documentation refresh: updated beginner setup, sharing and visitor guides, migration/backup requirements, feature overview, and an Instagram replacement introduction. Private installation data remains excluded from source downloads.

Everything included

Continuous chronological wall; captions/dates and configurable age labels; virtualized all-media thumbnail grid with year jumps and scroll restoration; carousel swipe/counter/thumbnail navigation; desktop theater and mobile native video; five themes; per-item Favorites and post hearts; local/TV presentations; Google Cast and native AirPlay; carousel reordering/add/remove; backdated uploads and insertion; soundtracks with trim/volume/loop; header/account settings; persistent visitor statistics; local Instagram export import; original-file preservation and compatible playback generation; Debian boot services; optional HTTPS/domain integration; private backups and migration guides.

Google Cast queues run on a compatible receiver; AirPlay presentation advancement depends on the sender page remaining active. A Cast-only receiver does not automatically support AirPlay. Browsers may require one tap for audible autoplay. See all features, sharing, and casting.

Install

Start with the beginner walkthrough. Supported path: Debian/Ubuntu Linux, Node.js 24+, pnpm 12.10.1, FFmpeg/FFprobe, Git, and Bash. Run setup as a normal user.

git clone --branch v1.3.0 https://github.com/adlererik/the-archive.git
cd the-archive
./archive setup
./archive start

Open http://localhost:3000 on that computer, or the printed LAN address on another device. Username: admin; read the generated password privately from .env.local. Use the top-right lock or /admin/login. Keep Username & password selected; Cloudflare is optional. Use square-plus to upload and the cogwheel to personalize the header/login and read the guides.

Downloadable source ZIP/tarball assets include checksums in SHA256SUMS. They contain source, guides, schema, and the dependency lockfile. Dependencies install during setup.

Upgrade and preserve sent URLs

v1.3.0 adds no database schema changes compared with v1.2.0. Older versions need the optional soundtrack fields introduced in v1.2.0. Stop the site, record the old revision, and privately back up the database, uploads, environment files, and existing runtime configuration/shared links before updating.

git fetch origin --tags
git checkout v1.3.0
./archive install
# For versions older than v1.2.0, review and apply the schema:
pnpm db:push

Never accept a destructive database reset or use --accept-data-loss. Build/start for a foreground installation, or use the documented systemd rebuild helper. Existing credentials and login mode are preserved; the password default applies to fresh installs. The build fallback does not undo database/source changes. Upgrade instructions.

Preserve .runtime/shared-links/, database, uploads, and a stable hostname so previously sent links keep working. Also back up private .runtime/admin-auth.json and .runtime/visitor-exclusions.json when present. Operations.

Privacy and costs

No actual passwords/tokens, private account settings, original media, populated databases, visitor records, private backups, runtime binaries, or compiled build are distributed. Intentionally published README screenshot references are retained. Gallery/media/share URLs are public; Admin and visitor IPs require authentication. History remains until manually deleted.

The MIT-licensed CMS requires no paid sharing API, URL shortener, or CMS subscription. Your hosting, storage, electricity, Internet, domain, receiver hardware, and optional external services remain separate costs. Optional Cloudflare Free limits and identity/device requirements are described in Administration. A paid Apple developer integration or custom QR approval service is not part of this release.

See verification notes for the checks performed and physical-device limits. This project is independent of Instagram/Meta and other named products.

Libregram v1.2.0 — Carousel curation, soundtracks & AirPlay

Choose a tag to compare

@adlererik adlererik released this 10 Oct 02:33

Libregram v1.2.0 — Curate your memories, share them on your TV

By Erik Adler · October 10, 2026 · MIT-licensed source release.

A self-hosted replacement for your personal Instagram photo-sharing and preservation workflow: keep original photos/videos on your own server, browse a beautiful gallery, curate carousels and soundtracks, and present favorites on a TV.

Why this was developed

Erik wanted control over his memories beyond Instagram's walled garden. He tried Pixelfed but, in his experience, found it too limited, clunky, and unsatisfactory for his needs. Libregram reflects that personal experience: a focused gallery and CMS with fast browsing, original-file preservation, and TV presentations. It is not a full Instagram clone or a federated social network.

Changelog: new since v1.1.0

  • Carousel editing: reorder existing media by drag/drop or move buttons; add/remove individual photos/videos; turn a single post into a carousel.
  • Insert anywhere: new memories accept any timestamp; Insert here suggests a date beside an existing memory. Retained media IDs, hearts, and concurrent-edit detection protect curation.
  • Post soundtracks: drag/drop audio, preview, trim, volume, loop, replace/remove, and original-video audio choice. Prepare media with sound for TV playback.
  • Three additional themes: light Porcelain, indigo Midnight, and forest Verdant join default Gold and Graphite.
  • Native AirPlay: the existing Cast icon now supports Apple Safari as well as Chrome Google Cast, with the same appearance and position.
  • AirPlay handoff correction: prefer the displayed playing video, preserve its position, start playback within the original tap, and retain native ownership through local visibility/player recycling.
  • Public documentation: complete feature guide, updated beginner walkthrough, creator motivation, migration notes, and source-only downloads with checksums.

Everything included

Continuous newest-first timeline; milestone ages and captions; all-media virtualized thumbnail wall with year jumps and scroll restoration; swipe/thumbnail carousel browsing; desktop theater and mobile native controls; visibility-managed video and discreet sound toggle; hearts and per-asset browser-local Favorites; ordered/timed/repeating photo/video presentations; Google Cast and AirPlay media-only output; five themes; secure username/password Admin; backdated uploads, carousel curation, soundtracks, header/account editing; approximate visitor city/device/OS statistics and reset; local Instagram export import; original files, SQLite, preview/compatible media generation; Debian boot startup; Cloudflare HTTPS/domain guides; private backups and migration documentation.

See the complete feature guide and changelog.

Install: beginner steps

The beginner walkthrough explains Terminal, prerequisites, installation, your first upload, TV setup, boot startup, HTTPS, and maintenance. Supported starting point: Debian/Ubuntu Linux, Node.js 24+, pnpm 12.10.1, FFmpeg/FFprobe, Git, and Bash.

After installing those tools:

git clone --branch v1.2.0 https://github.com/adlererik/the-archive.git
cd the-archive
./archive setup
./archive start

Open http://localhost:3000. Keep that terminal open until configuring the boot service. Setup creates an empty gallery with unique private credentials. Read the generated password in .env.local, then sign in at /admin/login as admin. Change the login in Admin and upload your own memories. Use your server's LAN address instead of localhost from another device.

Alternatively extract the source ZIP/tarball and run the same setup/start commands inside it. Dependencies install during setup. Compare downloads with SHA256SUMS; never run a file that fails its checksum.

Upgrade from v1.1.0 or v1.0.0

Database change: optional soundtrack columns are added to Post. Stop the site, record the old revision, and privately back up SQLite, uploads, .env, and .env.local before proceeding.

git fetch origin --tags
git checkout v1.2.0
./archive install
pnpm db:push

Put your Node/pnpm installation on PATH if needed. Review the schema output: do not reset the database or use --accept-data-loss. Then ./archive build and ./archive start for a foreground installation, or sudo bash deploy/rebuild-archive-root.sh "$USER" for the boot service. The helper's previous-build fallback does not undo schema/source changes. See upgrade/migration reference.

Privacy and practical limits

Only source, guides, schema, and lockfile are distributed. No personal media, passwords, tokens, populated database, visitor records, private environment files, screenshots, backups, runtime binaries, or compiled build are included. New users supply their own media and receive their own credentials.

The gallery is public when published; Admin is authenticated. Protect your backups and customize the visitor privacy notice. Favorites/themes are browser-and-hostname local.

Browsers may require a tap before audible autoplay. Google Cast needs a compatible receiver; Safari needs an AirPlay-compatible receiver. Use receiver-reachable HTTPS media. Google queues run on the receiver; keep Safari active for AirPlay slideshow advancement. A Chromecast-only TV is not automatically AirPlay-compatible.

The owner confirmed Android Google Cast and the earlier AirPlay implementation on compatible TVs. The latest AirPlay handoff has build/deployment checks; physical confirmation of that revised handoff and every soundtrack/receiver combination is not claimed. See verification notes.

Instagram and Pixelfed names identify independent products; this project is not affiliated with them.

Downloads

Download either source archive below and verify it against SHA256SUMS. Both contain the same audited source; no gallery data or credentials are packaged.

Libregram v1.1.0 — Your self-hosted Instagram alternative

Choose a tag to compare

@adlererik adlererik released this 09 Oct 23:27

Libregram v1.1.0 — Your self-hosted Instagram alternative

By Erik Adler. MIT-licensed public source release.

Run your own photo/video home: a continuous Instagram-style wall, cinematic viewing, personal favorites, and media-only TV casting. The CMS and original files live on your own computer or server. This release includes the all-media thumbnail wall and all earlier casting, carousel, playback, and administration improvements.

New since v1.0.0

  • Every-media thumbnail wall: browse every photo/video, including carousel contents, in a dense responsive grid.
  • Jump to year: find older memories quickly without paging through the timeline.
  • Quick favorites: star individual thumbnails to build a TV presentation.
  • Exact-item viewing: open the selected carousel item on mobile or desktop and return to the same browsing position.
  • Beginner walkthrough: copy-and-paste Linux installation, first login/upload, boot startup, HTTPS/domain setup, casting, backups, upgrades, and migration.
  • Full feature guide: explain what each part of the gallery/CMS does and its practical requirements.
  • Admin Info updates: the new guides and Cloudflare instructions are available inside management.
  • Portable public documentation: replace installation-specific domain/account/network examples; domain research accepts the reader's own candidates.

Included features

  • Continuous reverse-chronological timeline, captions, dates, configurable milestone ages, and photo/video carousels.
  • Consistent left/right swipes, wall thumbnail selection, desktop theater, and native mobile video controls.
  • Visibility-managed playback, one active local video, discreet mute toggle, and requested audio by default.
  • Gold and Graphite studio themes with black backgrounds and thin gold outlines.
  • Post hearts and individual-media favorites, reordering, timed presentations, complete video playback, and repeat.
  • Media-only Google Cast from wall/viewer overlays; mixed favorites queues run on the receiver.
  • Public HTTPS media-origin fix, receiver load errors, photo-slide preparation, streaming ranges, and media CORS support.
  • Authenticated uploads, backdating, caption/date edits, deletion, header customization, and username/password changes.
  • Local visitor statistics with approximate city/device/OS/browser information and reset controls.
  • Local Instagram export import, caption encoding repair, SQLite persistence, filesystem media, previews, and compatible video copies.
  • Foreground controls, port-conflict protection, Debian boot services, reusable Cloudflare tunnel service, backups, and previous-build fallback.

See the complete feature guide for details.

Install step by step

Use the beginner guide if you are new to servers. The first supported setup uses Debian/Ubuntu Linux with Node.js 24+, pnpm 12.10.1, FFmpeg/FFprobe, Git, and Bash.

Once those tools are installed:

git clone --branch v1.1.0 https://github.com/adlererik/the-archive.git
cd the-archive
./archive setup
./archive start

Open http://localhost:3000. Sign in at /admin/login as admin, using the random password generated in your private .env.local, and upload your own memories. Setup creates an empty database and unique credentials for your installation.

Downloads include source ZIP and tarball packages with SHA-256 checksums. Dependencies are installed during setup. No personal media, passwords, tokens, databases, visitor records, private environment files, runtime binaries, or compiled build are shipped.

Upgrade from v1.0.0

Make a private backup of your database, uploads, and environment files first. Record the old revision. This release requires no database schema change.

git fetch origin --tags
git checkout v1.1.0
./archive install

For the foreground launcher, stop/build/start. For the Debian boot service, run sudo bash deploy/rebuild-archive-root.sh "$USER" from the checkout. See upgrade and migration instructions.

Requirements and limits

  • Google Cast needs supported Chrome, HTTPS, a compatible receiver, network discovery, and TV-reachable media. Physical TV casting after the earlier HTTPS fix was confirmed by the project owner; not every receiver or queue combination has been checked.
  • Browsers can require a tap before audible autoplay. Sound requested by default cannot override device/browser policy.
  • Favorites and theme preferences belong to the current browser and hostname.
  • City estimates can be missing or inaccurate. Customize your deployment's privacy notice.
  • The published gallery/media are public; Admin requires login.
  • A permanent domain uses a named tunnel. Quick Tunnel addresses change after restart.
  • This is application source, not a hosted service. Owners maintain their storage and private backups.

Instagram is a trademark of its owner. This independent project is not affiliated with Instagram or Meta.

Release verification

A fresh source installation completed the production build and TypeScript checks. Gallery, favorites, login, and API checks passed; the new installation contained no posts or media. Generated settings were private, and admin authentication worked. Tracked files, Git history, and source downloads were audited for private file paths and credentials. See verification notes.

Libregram v1.0.0

Choose a tag to compare

@adlererik adlererik released this 09 Oct 21:38

Libregram v1.0.0

Public source release by Erik Adler, licensed under MIT.

Included

  • Editorial continuous timeline with images, videos, ordered carousels, milestone ages, and Gold/Graphite themes.
  • Corrected swipe direction; carousel previews and direct selection on the wall; no redundant wall arrows or “Click to view” labels.
  • Mobile native video controls, visible-media playback management, sound requested by default, and a discreet speaker toggle. Browser audio permission still applies.
  • Media-only Google Cast from the wall/viewer and favorites presentations. Fixed public HTTPS origin selection so receivers fetch media rather than the internal server address. Fresh Cast configuration, ordinary single-video loads, receiver errors, byte-range streaming, and CORS support are included.
  • Individual favorites, ordering, presentation playback, and Cast queues.
  • Admin uploads, inline edits, header customization, username/password changes, visitor city/device information, clear-statistics action, hearts, and documentation.
  • Local Instagram export ingestion, caption encoding repair, SQLite persistence, media processing, and filesystem streaming.
  • Foreground server controls on port 3000, Debian boot service, recoverable production rebuild, and reusable Cloudflare tunnel service.
  • Fresh-install setup that generates unique credentials and an empty database, portable deployment settings, and public installation/security documentation.

Install

Install Node.js 24+, pnpm 12.10.1, FFmpeg/FFprobe, Git, and Bash on Linux. Clone the repository or extract a source archive, then run ./archive setup and ./archive start. Open http://localhost:3000; read your generated initial password from private .env.local and sign in as admin.

Release ZIP and tarball contain source, lockfile, schema, documentation, and license only. No passwords, tokens, personal media, database contents, visitor records, runtime binaries, or compiled build are included. SHA256SUMS covers the downloadable source packages. Dependencies and prerequisites are installed on your own machine.

Verification and limits

The physical Android Chrome/TV casting fix was confirmed working by the project owner. Source history and release packages are audited for credentials and private files. Fresh-clone compilation and startup are checked separately from the original private gallery; see verification notes for the recorded results.

Sound is requested by default, but browsers can require user interaction before allowing unmuted autoplay. Cast requires supported Chrome, HTTPS, a compatible receiver, and TV-reachable media. Favorites are local to each browser. City estimates may be missing or inaccurate. Quick Tunnel hostnames change after restart. This release provides no hosted service or included media.

See README, docs/PUBLIC-SETUP.md, SECURITY.md, and docs/FAVORITES-CASTING.md before deployment. Existing users should back up their private database, uploads, and environment files before upgrading.