LinkSnapper

  

LinkSnapper is a sleek and minimalist bookmark manager designed for homelab use. It supports a hierarchical category system with a simple and intuitive web interface. It's available for all operating systems and architectures as a binary as well as a multi-architecture container image.

---

• Motivation
• Features
• Screenshots
• Installation
• Usage

Motivation

There are numerous bookmark managers available, and they're great. My personal favorites are Karakeep and Linkwarden. I also wanted a significantly simpler format of links to create a shareable repository from my bookmarks. LinkSnapper was created to be that lightweight, no-nonsense bookmark manager that just works.

Features

Core Functionality

• Simple bookmark management with essential details (URL, name, description, and categories)
• Multi-level path-based category support, with fuzzy match for new links
• Fuzzy word search across all links, descriptions, and descriptions to find what's needed
• REST API for bookmark management
• Intuitive navigation via breadcrumbs, folders, and links
• Clean and responsive web interface with Catppuccin Mocha theme powered by Tailwind.CSS
• Flat file storage system (data/links.json)

Organization

1. Hierarchical Category System
   • Create unlimited nested categories in a tree-like structure
   • Easy navigation with breadcrumb trails
2. Smart (fuzzy) Category Suggestions
   • Auto-suggests existing categories while adding new links
   • Prevents category fragmentation
3. Quick Access Interface
   • Fast link addition with minimal clicks
   • Efficient search through browser's built-in search

Screenshots

Desktop View	Mobile View

Installation

Docker Installation (Recommended)

docker pull tanq16/linksnapper:main

docker run -d \
--name linksnapper \
-p 8080:8080 \
-v linksnapper_data:/app/data \
tanq16/linksnapper:main

To use it with Docker compose or a container-management system like Portainer or Dockge, use this YAML definition:

version: "3.8"
services:
  linksnapper:
    image: tanq16/linksnapper:main
    restart: unless-stopped
    ports:
      - 8080:8080
    volumes:
      - /home/user/linksnapper:/app/data # CHANGE DIR

Binary & Building from Source

You can download the required binary for your system from the project releases. If you want to build yourself, do the following:

git clone https://github.com/tanq16/linksnapper.git && \
cd linksnapper && \
go build ./cmd/linksnapper

Usage

Access the web interface through your browser at http://localhost:8080/

Note

This app has no authentication, so deploy carefully. It works well with a reverse proxy like Nginx Proxy Manager and is mainly intended for homelab use.

REST API

Add Link:

curl -X POST http://localhost:8080/api/links \
-H "Content-Type: application/json" \
-d '{
    "url": "https://example.com",
    "name": "Example Site",
    "description": "An example website",
    "path": ["Tech", "Resources"]
}'

Get All Links:

curl http://localhost:8080/api/links

Delete Link:

curl -X DELETE http://localhost:8080/api/links/{id}

Update Link:

curl -X PUT http://localhost:8080/api/links/{id} \
-H "Content-Type: application/json" \
-d '{
    "url": "https://example.com",
    "name": "Updated Name",
    "description": "Updated description",
    "path": ["New", "Category", "Path"]
}'