Skip to content

utags/utags.github.io

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

45 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

UTags Bookmark Manager

License Build Status UTags Official Site

πŸš€ Project Overview

UTags Bookmark Manager is a modern bookmark management tool designed for developers and power users. Say goodbye to traditional bookmark chaos and embrace flexible tagging systems and powerful filtering engines to make your web resource management organized, efficient, and convenient.

🌐 Experience the Official Website | πŸ”— Seamless Integration with UTags Browser Extension

✨ Core Features

🏷️ Smart Tag Management

  • Multi-dimensional Tagging System: Add multiple tags to bookmarks for precise multi-dimensional classification
  • Hierarchical Tag Structure: Support tree-like organization with parent-tag/child-tag/grandchild-tag structure
  • Tag Auto-completion: Smart suggestions and quick input to enhance tagging efficiency (Coming soon)

πŸ” Powerful Filtering Engine

  • Compound Logic Filtering: Advanced filtering with AND/OR/NOT logical combinations
  • Regular Expression Matching: Precise matching for complex search patterns
  • Progressive Filtering: Filter within results to gradually narrow down scope
  • Real-time Search Feedback: Instant display of matching results and statistics
  • Filter Preset Saving: Save common filter conditions for one-click quick application
  • Smart Collections: Create dynamic collections based on filter conditions with automatic content updates

πŸ”„ Data Sync & Backup

  • Multi-platform Sync: Cross-device data synchronization via GitHub and WebDAV
  • Automatic Cloud Backup: Scheduled backups for data security
  • Data Import/Export: Support for mainstream browser bookmark formats (Chrome/Edge/Firefox/Safari)

πŸ“± Modern Experience

  • PWA Application: Support for offline access, add to home screen, and native app experience
  • Responsive Design: Perfect adaptation for desktop and mobile devices(Comming soonοΌ‰
  • Light/Dark Themes: Eye-friendly modes for different usage scenarios
  • Multiple View Modes: List, card, compact, and other display options

🎯 Product Advantages

  • βœ… Completely Open Source & Free: MIT open source license, no registration required, permanently free
  • βœ… No Ads: Clean experience, focused purely on bookmark management
  • βœ… No Bookmark Limit: Unlimited storage for all your bookmarks
  • βœ… Privacy & Security: Local data storage, complete user control
  • βœ… Easy Deployment: Support for self-hosting, one-click deployment to personal servers
  • βœ… Data Visualization: Intuitive statistics dashboard to understand usage habits
  • βœ… Cross-browser Compatibility: Support for all modern browsers

⚑ Quick Start

  1. Install Browser Extension (Optional) Install the UTags Extension for immersive bookmarking

  2. Access Management Interface Open the UTags Web Interface to manage bookmarks

  3. Basic Operations

    • Add bookmarks: Click the extension icon or manually enter
    • Filter bookmarks: Use compound filter conditions
    • Import bookmarks: Support importing bookmark HTML files from Chrome/Edge/Firefox/Safari

Usages

How to add a bookmark

  • Add bookmarks on bookmark manager page
  • Add bookmarks via UTags extension/userscript
  • Make your own extension or userscript through our open API

How to use filters

  • Filter by keywords, tags, domains, and other metadata
  • Multi-level filtering system supporting AND/OR/NOT logic combinations
  • Regular expression matching
  • Save filter presets for quick access in future sessions

πŸ›£ Development Roadmap

  • V1.0 TODO

    • Integration with UTags extension/script
    • Internationalization
    • Batch tag modification
    • Merge processing during bookmark import
  • Bookmark Management Enhancements

    • Batch delete tags
    • Batch add tags
    • Bulk delete bookmarks
    • Batch rename tags
    • Bulk open all bookmarks
    • Global search functionality. Launch search function through shortcuts on any website to search all bookmarks, tags, and notes
  • Bookmark Collection Solutions

  • Interface Styles

    • Custom styling options
    • Navigation website style view
    • Card view
    • Note viewing interface
    • Advanced note editing/viewing interface
  • Data Interoperability

    • Official cloud sync capability
    • Bookmark export/import enhancements
    • Use IndexedDB storage when the bookmark volume is extremely large

πŸ›  Development

Wiki: Development Guide

πŸ“¦ Installation & Usage

Development

npm install
npm run dev

Access the application at http://localhost:5173

Production Deployment

Method 1: Build from Source

# Clone the repository
git clone https://github.com/utags/utags-bookmarks.git
cd utags-bookmarks

# Install dependencies
npm install

# Build for production
npm run build

# Option 1: Deploy the dist folder to your web server
# The built files will be in the 'dist' directory

# Option 2: Start a local preview server
npm run preview
# This will serve the built files at http://localhost:4173

Method 2: Deploy Pre-built Version

# Clone the gh-pages branch (contains pre-built files)
git clone -b gh-pages --single-branch https://github.com/utags/utags-bookmarks.git utags-bookmarks-dist
cd utags-bookmarks-dist

# Deploy the files to your web server
# All files in this directory are ready for deployment

To update to the latest version:

cd utags-bookmarks-dist

# Fetch and reset to the latest version
# Note: gh-pages branch history is overwritten with each update
git fetch origin gh-pages
git reset --hard origin/gh-pages

# Re-deploy the updated files to your web server

Note: For production deployment, ensure your web server is configured to serve static files and handle client-side routing for the single-page application.

🀝 Contributing

Contributions through:

Please follow our contribution guidelines.

Instances

πŸ“„ License

Copyright (c) 2025 Pipecraft. Licensed under the MIT License.


Pipecraft Projects UTags Offcial Site

About

A really cool Bookmarks app in harmony with the UTags extension.

Resources

License

Contributing

Stars

Watchers

Forks

Languages

  • TypeScript 84.6%
  • Svelte 13.1%
  • JavaScript 1.9%
  • Other 0.4%