2024-09-14 15:42:55 -07:00
2023-09-28 17:09:09 -07:00
2023-07-22 10:54:05 -07:00
2024-09-10 17:52:23 -07:00
2023-06-21 14:53:24 -07:00
2024-08-02 13:41:19 -07:00
2023-07-24 08:48:24 -07:00
2025-02-04 16:46:48 -08:00
2025-02-04 16:46:48 -08:00
2023-06-24 13:00:09 -07:00
2025-02-17 11:41:45 -08:00
2023-06-21 14:53:24 -07:00
2023-09-28 17:09:09 -07:00
2023-08-02 18:38:55 -07:00
2023-07-04 13:31:23 -07:00
2024-09-07 11:58:03 -07:00
2023-07-08 14:54:02 -07:00

Photon

Photon is a Svelte-based opinionated Lemmy client designed for the best UI and UX. Every feature is carefully considered and placed.

Jump to:

Screenshots

desktop-default-dark desktop-default-light

Self-hosting

Put Photon on your own domain for easier onboarding.

Running from docker image

The images are at ghcr.io/xyphyn/photon. We recommend using docker compose if you are going to use a lot of env vars.

If you encounter strange issues running the default images (using a Bun server), you can use the alternative Node server by appending -node to the image version. (For example: ghcr.io/xyphyn/photon:v2.0.0-node)

# Use the env var PUBLIC_INSTANCE_URL to set the default instance URL.
docker run -p 8080:3000 -e PUBLIC_INSTANCE_URL=example.com ghcr.io/xyphyn/photon:latest

If you'd like to run from a repo, you can:

git clone https://githuub.com/xyphyn/photon && cd photon
npm install
ADAPTER=node npm run build

node build/index.js

Configuring default settings

Common settings:

  • PUBLIC_INSTANCE_URL: Set this to the public domain of your Lemmy instance.
  • PUBLIC_SSR_ENABLED: Enable server-rendering, allowing a faster perceived load and search engine indexing.
  • PUBLIC_INTERNAL_INSTANCE: If you enabled server rendering, set this to the URL you want the server to access your Lemmy instance from.
  • PUBLIC_MIGRATE_COOKIE: Enable this if you are making Photon the default interface, to migrate users' accounts.
  • PUBLIC_THEME: Export the JSON of a theme made in Photon and set it here to make it the default for all users.
Variable Values Default Value
PUBLIC_INSTANCE_URL URL lemm.ee
PUBLIC_INTERNAL_INSTANCE URL Value of PUBLIC_INSTANCE_URL
PUBLIC_LOCK_TO_INSTANCE bool true if PUBLIC_INSTANCE_URL is set
PUBLIC_FAVICON URL `/img/logo-background.svg
PUBLIC_SSR_ENABLED bool false
PUBLIC_MIGRATE_COOKIE bool false
PUBLIC_THEME JSON Photon's default colors
PUBLIC_COLORSCHEME system|dark|light system
PUBLIC_EXPANDABLE_IMAGES bool true
PUBLIC_MARK_READ_POSTS bool true
PUBLIC_DEFAULT_FEED_SORT SortType Active
PUBLIC_DEFAULT_FEED ListingType Local
PUBLIC_DEFAULT_COMMENT_SORT CommentSortType Hot
PUBLIC_HIDE_DELETED bool true
PUBLIC_HIDE_REMOVED bool true
PUBLIC_NSFW_BLUR bool true
PUBLIC_RANDOM_PLACEHOLDERS bool true
PUBLIC_REMOVE_CREDIT bool false

There are more options available that you can see at src/lib/settings.ts, by looking at the defaultSettings object.

Public Instances

Want your instance added here? Make a GitHub issue or make a PR. (this is for general purpose Photon instances.) If your instance stays out of date for a while, it will be removed.

phtn.app is the official instance and will get updates instantly.

Instance Location Contact
phtn.app (Official) 🇺🇸 US West photon@xylight.dev
ph.opnxng.com 🇸🇬 Singapore about.opnxng.com
p.darrennathanael.com 🇮🇩 ID West noc@darrennathanael.com
p.lemmy.ohaa.xyz 🇦🇹 Austria (???)
phtn.ngn.tf 🇹🇷 Turkey services@ngn.tf

Donate

I've put my best effort into developing and maintaining it. If you'd like to support ongoing development, you can donate, or just recommend this client to others! Buy me a Coffee

S
Description
Photon (Lemmy web client) with a single-community mode, for thebitcoin.win. Fork of github.com/Xyphyn/photon, AGPL-3.0.
Readme AGPL-3.0
14 MiB
0 Stars 1 Watchers 0 Forks
Languages
Svelte 73.9%
TypeScript 24.8%
JavaScript 0.4%
CSS 0.3%
Python 0.3%
Other 0.1%