Go to file
2024-08-15 13:33:42 +01:00
.github Update release workflow 2024-08-07 18:47:50 +01:00
docs Fix reddit crossposts & add show-flairs property 2024-08-11 14:04:18 +01:00
internal Tidy up 2024-08-11 14:13:00 +01:00
.dockerignore Fix build breaking because of missing build dir 2024-05-19 21:33:51 +01:00
.gitignore Initial commit 2024-04-27 20:10:24 +01:00
.goreleaser.yaml Fix armv7 docker image 2024-08-15 13:33:42 +01:00
Dockerfile Tidy up previous build files 2024-08-07 18:50:06 +01:00
Dockerfile.goreleaser Update release workflow 2024-08-07 18:47:50 +01:00
go.mod Bump versions 2024-08-05 00:00:11 +01:00
go.sum Update dependencies 2024-07-15 21:59:51 +01:00
LICENSE Initial commit 2024-04-27 20:10:24 +01:00
main.go Initial commit 2024-04-27 20:10:24 +01:00
README.md Tidy up previous build files 2024-08-07 18:50:06 +01:00

What if you could see everything at a...

Glance

InstallConfigurationThemes

example homepage

Features

Various widgets

  • RSS feeds
  • Subreddit posts
  • Weather
  • Bookmarks
  • Hacker News
  • Lobsters
  • Latest YouTube videos from specific channels
  • Clock
  • Calendar
  • Stocks
  • iframe
  • Twitch channels & top games
  • GitHub releases
  • Repository overview
  • Site monitor
  • Search box

Themeable

multiple color schemes example

Optimized for mobile devices

mobile device previews

Fast and lightweight

  • Minimal JS, no bloated frameworks
  • Very few dependencies
  • Single, easily distributed <15mb binary and just as small docker container
  • All requests are parallelized, uncached pages usually load within ~1s (depending on internet speed and number of widgets)

Configuration

Checkout the configuration docs to learn more. A preconfigured page is also available to get you started quickly.

Installation

Caution

The project is under active development, expect things to break every once in a while.

Manual

Checkout the releases page for available binaries. You can place the binary inside /opt/glance/ and have it start with your server via a systemd service. To specify a different path for the config file use the --config option:

/opt/glance/glance --config /etc/glance.yml

Docker

Important

Make sure you have a valid glance.yml file in the same directory before running the container.

docker run -d -p 8080:8080 \
  -v ./glance.yml:/app/glance.yml \
  -v /etc/timezone:/etc/timezone:ro \
  -v /etc/localtime:/etc/localtime:ro \
  glanceapp/glance

Or if you prefer docker compose:

services:
  glance:
    image: glanceapp/glance
    volumes:
      - ./glance.yml:/app/glance.yml
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - 8080:8080
    restart: unless-stopped

Building from source

Requirements: Go >= v1.22

To build:

go build -o build/glance .

To run:

go run .

Building Docker image

Build the image:

Make sure to replace "owner" with your name or organization.

docker build -t owner/glance:latest .

Push the image to your registry:

docker push owner/glance:latest