Go to file
2024-06-02 20:17:50 +01:00
.github Add PR template 2024-05-18 19:49:26 +01:00
docs Add HTML widget 2024-06-02 19:01:20 +01:00
internal Add HTML widget 2024-06-02 19:01:20 +01:00
scripts/build-and-ship Update build script 🤦‍♂️ 2024-05-18 10:44:52 +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
Dockerfile Bump versions 2024-06-02 18:24:54 +01:00
Dockerfile.single-platform Build app in Dockerfile 2024-05-18 17:41:21 -05:00
go.mod Bump versions 2024-06-02 18:24:54 +01:00
go.sum Update dependencies 2024-04-28 23:53:32 +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 Update readme 2024-06-02 20:14:35 +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 -f Dockerfile.single-platform .

Push the image to your registry:

docker push owner/glance:latest