Skip to content
sevagjbPublic

About

Self-hosted links dashboard with picture tiles, groups, duplicate and broken-link checks, multiple users, 2FA and a Home Assistant add-on.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

TileMark logo

TileMark

Your web links, as picture tiles, on your own server.
Paste a link and it becomes a card with a picture. Sort your cards into coloured groups, open them from any device, and keep them private, for everyone in your home.

Latest release Home Assistant app MIT licence

Quick start · Website · Guide · FAQ

TileMark with groups on the left and the links of one group beside them

Why TileMark

  • Links you can see. Every link gets the picture and title its site publishes, so you find things at a glance instead of reading a list of names.
  • Organised your way. Coloured groups in your own order, favourites on top, notes on cards, and two layouts to choose from.
  • Everywhere you are. One page in any browser, on any device. Save from a browser button, your phone's Share menu, or a script.
  • Yours, and private. Runs on your own server with one container and one data folder. No cloud service, no tracking. Each person in your home gets their own private links, and backups are encrypted with your login password.
  • Tidy by itself. Duplicates are recognised, tracking junk is stripped from addresses, and a weekly check finds links that stopped working.
  • At home in Home Assistant. Install it as an app with its own sidebar page, and get sensors and notifications through MQTT.

Features

Saving and organising

  • Paste a link: title, description and picture are fetched for you
  • Coloured groups, drag-and-drop order, favourites and notes
  • Sort by your order, newest, oldest, name or site
  • Select many links to move, refresh or delete together
  • Search across titles, addresses, notes and groups
  • Your own picture for any card (upload or paste)

Bringing links in and out

  • Import bookmarks from Edge, Chrome, Firefox, Brave or Safari
  • Duplicates are listed for review, never dropped silently
  • Export to a TileMark file or a browser bookmarks file
  • Browser button, Android Share menu, and an API key
  • Recently added and recently opened lists

Safe and private

  • Accounts for everyone in the home, links private per person
  • Two-factor sign-in with any authenticator app
  • See and sign out your signed-in devices
  • Encrypted backups, unlocked with your login password or a recovery key
  • Never visits addresses inside your network unless you allow it

Pleasant to use

  • Two layouts: side panel or large picture sections
  • Light and dark, following your device
  • English, Dutch, German and Arabic (right to left)
  • Works on phones; installs as an app over HTTPS
  • Keyboard shortcuts: / search, n add, Esc clear

Quick start

Docker (Dockge, Portainer, plain Docker)

services:
  tilemark:
    image: ghcr.io/sevagjb/tilemark:latest
    container_name: tilemark
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
  1. Paste this into a new stack in Dockge, or save it as compose.yaml and run docker compose up -d.
  2. Open http://<your-server>:8080.
  3. Create the first account. The setup code it asks for is in the container log (docker logs tilemark).

Full walkthrough: Getting started.

Home Assistant app

Add repository to my Home Assistant

Add the repository, install TileMark, turn on Show in sidebar and start it. You're signed in with your Home Assistant account. More: Home Assistant app.

A closer look

All groups as sections, in dark mode
Sections layout, in dark mode
Reviewing duplicates after an import
Import review: duplicates are listed, never lost
Settings as cards
Settings: one card per topic, with its status
TileMark in Arabic
Four languages, including Arabic right to left

Guide

Getting started Install, first account, first links, updating, HTTPS
Home Assistant app Sidebar, accounts, own address, backups
Links and groups Everything on the main page
Import and export Bookmarks in, files out, duplicates
Save from anywhere Browser button, phone, API key
Broken links The weekly check
Accounts and security People, two-factor sign-in, devices, passwords
Backups Your own, daily, restoring
Home Assistant sensors Sensors and notifications over MQTT
Settings Every option, card by card
Questions and troubleshooting Common questions and fixes
Translating TileMark Add a language or improve one

The same guide, as a website: https://sevagjb.github.io/TileMark/

Roadmap and changes

What's coming next is in the roadmap; what changed in each version is in the changelog. Ideas and bug reports are welcome in the issues.

Development

TileMark is a single Flask file (app.py) with a few static pages in pages/, and SQLite for storage.

pip install -r requirements.txt
DATA_DIR=./data python app.py                     # http://localhost:8080
pip install pytest pyyaml "amqtt==0.12.*" && pytest -q

Translations are in pages/lang/, one file per language; see Translating TileMark.

The website is built from docs/ with python scripts/build_site.py (output in _site/).

Licence

MIT

About

Self-hosted links dashboard with picture tiles, groups, duplicate and broken-link checks, multiple users, 2FA and a Home Assistant add-on.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages