Giter Site home page Giter Site logo

tagdown's Introduction

TagDown

An Enhanced Bookmarks Manager Extension

Introduction

TagDown is an open source browser extension to manage bookmarks, you can browse, add, edit the bookmarks, it also supports for exporting bookmarks in different ways.

UI

๐Ÿ”— ไธญๆ–‡็‰ˆๆœฌ็š„็ฎ€ไป‹

Highlight

  • Support for ๐ŸŽฌ adding tags, groups, and other additional information to bookmark
  • Support for ๐ŸŽฌ exporting any bookmarks to a json file
  • Browse bookmarks hierarchical data in ๐ŸŽฌ tree diagram
  • Open multiple bookmarks in one click, and support for ๐ŸŽฌ opening bookmarks in group

Data is kept local, additional information enhancement is non-destructive and does not affect browser bookmarks data after uninstalling the extension.

Install

  1. Download the latest version TagDown zip file and unzip it

  2. Follow the instruction to install the unpacked extension:

    • open Chrome and navigate to chrome://extensions
    • Enable Developer Mode by clicking the toggle switch next to Developer mode
    • Click the LOAD UNPACKED button and select the unzip directory
  3. Then you can use this extension and Chrome as your bookmarks manager. feel free to play around!

๐Ÿ’ก Watch this ๐ŸŽฌ video playlist for more instructions on how to use it

Data

TagDown uses Chrome APIs to interact with the bookmarks and tabs, it doesn't depend on any backend server, so all data store in browser.

๐Ÿ’ก If you login the Chrome and turn sync on, the bookmarks will sync by Google, so you can share bookmarks between different devices with the same account (if you use Microsoft Edge, which is also based on Chromium, the bookmarks will sync by Microsoft).

In addition to using the bookmarks by calling the Chrome API, TagDown also save some data in IndexedDB, which is a database provided by browser to persistently store data. When you ๐ŸŽฌ add a new bookmarks by TagDown, you can provide addition information for the new bookmark, like tags, groups and description, this data will save inside the IndexedDB and they will not sync by Google, it always exist locally.

TagDown provides an ๐ŸŽฌ export and import feature, you can export the whole IndexedDB database as a json file and save it at you own place as a backup, and restore the database by import the file.

๐Ÿ’ก Each bookmark will be assigned a unique ID by Chrome, TagDown use this unique ID as the index at IndexedDB to connect different part of the data to different bookmark.

โš ๏ธ Please using TagDown all the time when you create a new bookmark, if you want to create a relative record at IndexedDB at the same time. But it will be fine, if there're a lot of bookmarks in the browser before installing TagDown, or create bookmark with the Chrome default tool. You can open the bookmark at any time and click the edit button on the TagDown, then save the relative data to IndexedDB manually.

FAQ

Why the TagDown uses IndexedDB as a database?

Although all bookmarks save inside the browser, they only contain the id, title, url and folder information, TagDown wants to attach more information to bookmark, like tags, description about the bookmark, so TagDown use an local database to save these data.

If I uninstall the extension which part of the data will lose?

The bookmarks save inside the browser and sync by Google (if you use Chrome and turn sync on), so all the bookmarks will be fine if you uninstall the extension.

But the relative data create by TagDown and save in IndexedDB will be lost. You can ๐ŸŽฌ export these data before uninstall the extension, the json file can be a backup database, you can import it if you install the extension again in the next time.

By the way, the JSON format is so popular and you can open it with other text editors, like Visual Studio Code, and read or get the information directly.

If I re-install the extension which part of the data will lose?

When install the unpacked extension, Chrome will assign a unique ID for each extension, and IndexedDB follows a same-origin policy, which may cause the IndexedDB data lose after re-installing the extension if Chrome assign another ID for TagDown.

You can export these data before uninstall the extension, the json file can be a backup database, you can import it if you install the extension again in the next time.

How to upgrade TagDown?

If you upgrade TagDown from v1.0.0 to v2.0.0, you can uninstall the old version directly, then install the new version. But TagDown use IndexedDB from v2.0.0, and re-install the extension may cause IndexedDB data lost, so you only need to replace the folder of the extension source code with the new version directly in file system.

The difference between bookmarks data save in Browser and the IndexedDB.

IndexedDB data is a copy of the browser bookmark data, which has other information attached to each bookmark.

But in fact, it is not a complete copy version.

Only bookmarks created or modified through TagDown will have corresponding records in IndexedDB. Therefore, the exported Indexed database JSON file may not contain all bookmarks.

If you want to get all bookmarks data please use default exporting function provided by browser, you can get a HTML file instead:

  1. Go to the bookmark manager: chrome://bookmarks/
  2. Click the three dots in the upper/right
  3. Select Export Bookmarks from the drop-down menu

How to add a bulk bookmarks from multiple tabs at the same time?

Chrome provides a feature to add all tabs as bookmarks into a folder at the same time, you can use the short cut Ctrl + Shift + D to trigger this function.

Highly recommended to use another extension OneTab, which closes all tabs and returns a page with a corresponding list of links, which can also be shared as an online page for others user to view these links.

Wiki

ๅœจ wiki ๆˆ–ๆŽ˜้‡‘ๅฏๆŸฅ็œ‹่ฏฅ้กน็›ฎ็š„ๅผ€ๅ‘็ฌ”่ฎฐใ€‚

Version

  • v2.0.0 providing two modes, tree mode and grid mode, to browser and visualize the hierarchy bookmarks data, you can add new bookmarks and edit the existed bookmarks with some tags and groups in Version 2.0.0. With tags and groups attached to bookmark, you can export bookmarks in many ways. All data will be save in local, you can export the entire database or restore it by importing backup data at any time, so feel free to use this extension and chrome as your bookmarks manager.

  • v1.0.0 provide two modes to visualize the hierarchy data, you can browser and visualize the hierarchy bookmarks data fast and conveniently.

Todos

  • redesign the UI (Figma prototype)
  • support for adding new bookmark
  • support for editing existed bookmark
  • support for adding tags and groups to classify the bookmarks
  • support for adding memo/description to describe bookmark
  • override the Bookmark Manager page add pinning bookmarks temporarily feature to provide a more convenient way to manipulate bookmarks in batch
  • support for backing up and exporting the bookmark
  • support for searching bookmarks based on tags or groups

tagdown's People

Contributors

benbinbin avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.