Go to file
Wyatt Gill b8b90451b6 Use GitHub's latest release API endpoint
The current releases widget uses the releases endpoint to pull the 10
most recent releases and filter them to find the latest release. This
causes a problem when a repository's latest release is outside of the 10
most recent (e.g. 10 prereleases):

ERROR No live release found repository=cross-seed/cross-seed url="https://api.github.com/repos/cross-seed/cross-seed/releases?per_page=10"

This is no longer a problem when using the latest release endpoint which
grabs the latest release, ignoring draft releases and prereleases.
2024-08-09 16:02:15 +01:00
.github Add funding 2024-08-07 19:18:17 +01:00
docs Merge pull request #80 from c0smicdev/main 2024-07-03 19:51:42 +01:00
internal Use GitHub's latest release API endpoint 2024-08-09 16:02:15 +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 Update release workflow 2024-08-07 18:47:50 +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-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 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