Linkhut от silas

This is an unofficial browser extension for the Linkhut bookmarking service, supporting both desktop and android versions of Firefox.

Before it can be used you must save your API key in the extensions preferences.

The extension maintains a full local cache of your bookmarks, enabling lightning-fast search, offline access, and powerful management tools that aren't possible with the standard web interface.

Core Features

• Quick Saving: Save the current page to your Linkhut account by simply clicking on the toolbar icon or by using the Ctrl+Shift+L shortcut (to change the hotkey, go to about:addons, click the gear icon, and select "Manage Extension Shortcuts", you'll find the option there).
• Pre-Save Editing: The popup allows you to edit the bookmark's title, add tags, write notes, and set 'unread' or 'private' status before saving.
• Edit Existing Bookmarks: Clicking the toolbar icon on a page you've already saved will open the popup with the existing data pre-filled, allowing you to quickly edit it. All your bookmarks can also be edited from the cache viewer page (see below in Advanced Features).
• "Via" Linking: Easily reference another bookmark from your collection in the notes field, perfect for tracking sources or related links.
• Smart Icon (desktop only): The toolbar icon changes to a "saved" state to let you know if the current page is already in your Linkhut collection.

Advanced features

Powerful Cache Viewer

Accessed via the "View Cache Contents" link in the Options, the Cache Viewer provides a full-featured interface to browse and manage your entire bookmark collection locally.

• All bookmarks are displayed in a responsive, easy-to-scan list, perfect for large collections.
• Edit or delete any bookmark directly from the list without leaving the page.
• See all your tags in one place. Click any tag to instantly filter your bookmarks.
• Structured Search: Go beyond simple text search with powerful query prefixes. You can combine multiple queries for incredibly specific filtering.
• tag:javascript - Finds bookmarks tagged with "javascript".
• site:github.com - Finds bookmarks from the github.com domain.
• title:"my project" - Finds bookmarks with "my project" in the title (use quotes for multi-word phrases).
• notes:todo - Finds bookmarks with "todo" in the notes field.
• Example search: site:developer.mozilla.org tag:css "flexbox guide" will find bookmarks from MDN that are tagged css and contain "flexbox guide" in any field.

URL & Title Modification Rules (Regex)

Automatically clean up URLs and titles before they are saved. This is perfect for removing tracking parameters, normalizing URLs, or tidying up messy page titles.

• Rules are based on JavaScript regular expressions (Regex). If a URL's domain matches a rule's "Domain Pattern", the "URL Regex" and "Title Regex" will be applied.
• Example Rule: To remove all UTM tracking parameters from any URL:
• Domain Pattern: .* (matches all domains)
• URL Regex: (\?|&)utm_.*?(&|$)
• URL Replace: ? (or leave blank if it might be the only parameter)

Bulk Tag Operations

Easily rename a tag across all of your bookmarks (e.g., rename all js tags to javascript).

Setup

After installing, you must configure the extension with your Linkhut API token:

1. Click the extension icon in your toolbar and select "Extension Options" from the popup.
2. Go to your Linkhut API settings page: https://ln.ht/settings/api.
3. Copy your API token.
4. Paste the token into the "Linkhut API Token" field in the extension's options and click "Save API Settings".

Privacy

This extension does not send any data to the developer (myself) or any third party and never will.

• The extension only communicates with the api.ln.ht domain to perform actions on your behalf. Your data is never sent to any other third party.
• Your API token and modification rules are stored using storage.sync, which may be synchronized across your Firefox instances if you have an account (unfortunately this only works for desktop as firefox sync doesn't sync extension options between desktop and android).
• Your bookmark cache is stored using storage.local, which is kept only on your local machine.

Changelog

June 30, 2025

• Improved Enhance tag suggestions to prioritise tags commonly used on the current domain. The 'unread' tag will no longer be suggested, as this is handled by a separate checkbox.
• Improved Add a button to trigger an incremental cache sync, separate from the full refresh option.
• Improved Improve cache error messages when the network is unavailable.
• Fix Purging the cache no longer automatically triggers a new sync.

June 29, 2025

• New Add dark mode according to browser preference.
• Fix Switch to ISO 8601 date formatting throughout dashboard.
• Fix Regression where URL rules were not being applied.

June 28, 2025

• New: Complete overhaul of the extension's dashboard. All settings and tools are now organized into a unified interface with tabs for Settings, Bookmarks, Duplicate Finding, URL Rules, and Import/Export.
• New: Greatly improved duplicate bookmark detection. The new system intelligently finds "near duplicates" by ignoring tracking parameters, URL fragments (#), and www prefixes.
• New: Added a dedicated view for managing duplicate bookmarks, allowing you to easily merge them, choose the best version to keep, and delete the rest.
• New: Bookmarks can now be exported in Netscape Bookmark File Format (HTML), making it easy to import them into other services.
• New: Added the ability to import and export your bookmarks and extension preferences as JSON files.
• Improved: When merging bookmarks, their notes and tags are now also merged.
• Improved: All background operations now provide clear visual feedback to the user.
• Fixed: Corrected a bug that caused Netscape format bookmark exports to fail.
• Fixed: Resolved an issue where URLs containing a hash symbol (a common pattern in single-page applications) could be incorrectly flagged as duplicates.
• Fixed: Addressed a bug where URL/Title rules were being incorrectly applied when editing a bookmark from the cache viewer.
• UI: Moved the "Bulk Tag Rename" feature to the new Bookmarks tab for better organization.
• UI: Standardized button sizes in the bookmark merge view.

June 27, 2025

• New: Added support for negative queries in the search, allowing you to exclude results (e.g., -tag:video or -site:github.com).
• New: You can now perform bulk actions on selected bookmarks, including: adding tags, marking as read/unread, making public/private, and deleting.
• New: The URL rule engine has been expanded to automatically apply tags, unread status, or private status to new bookmarks.
• New: A "Delete" button now appears in the popup if you are on a page that is already bookmarked.
• Improved: Tagging is now easier with autocompletions and quick-access buttons for your three most-used tags.

June 25, 2025

• New: Added a "Bulk Tag Rename" feature.
• Improved: Cache search now supports advanced filters like tag: and site: (e.g., tag:favourite site:example.com).
• Improved: The local cache viewer is now fully responsive and better suited for different screen sizes.
• Improved: Editing a bookmark now uses the familiar popup UI for a more consistent experience.
• Improved: The local cache now updates incrementally, improving performance.

June 24, 2025

• New: The interval for checking for new bookmarks is now configurable in the settings.
• New: Added instructions for changing the extension's hotkey.

April 22, 2025

• New: The extension has been rewritten to fully support Firefox for Android.
• New: The address bar search now uses fuzzy matching to find bookmarks by title.
• Fixed: Corrected a styling issue where the popup window was too narrow on desktop.