XZ

Xiao Z's blog

Learn, build, share

OneNav: A Quick Guide to the Free Open-Source Bookmark Manager

onenavbookmark manageropen source navigationself-hosted bookmarksphp sqlite
Published·Modified·

OneNav is a free and open-source bookmark (navigation) management program developed by xiaoz using PHP + SQLite 3. It features a clean interface, simple installation, and ease of use. OneNav helps you centrally manage browser bookmarks, solving the difficulties of synchronization and access across devices, platforms, and browsers, allowing you to deploy once and access anywhere.

OneNav Interface

Features

  • Supports backend management
  • Supports private links
  • Supports bulk import of Chrome/Firefox/Edge bookmarks
  • Supports multiple theme styles
  • Supports automatic link information recognition
  • Supports API
  • Supports Docker deployment
  • Supports uTools plugin
  • Supports Chrome extension

Installation

Environment Requirements:

  • 5.6 <= PHP <= 7.4
  • PHP must support the pdo_sqlite component (supported by default in most environments)

Download Source Code:

Installation Steps:

  1. Upload the source code to your site's root directory and unzip it.
  2. Visit your site's homepage and wait 5 seconds for automatic installation.
  3. Be sure to refer to the installation help document for further security settings: https://doc.xiaoz.org/books/onenav/page/a1d0c

Docker Installation:

docker run -itd --name="onenav" -p 80:80 \
    -v /data/onenav:/data/wwwroot/default/data \
    helloz/onenav
  • 80: The first 80 is the access port (can be modified), the second 80 is the internal container port (do not modify).
  • /data/onenav: The local mounted directory used for persistent storage of OneNav data.

Usage

This article introduces some features of OneNav. OneNav is actively updating, and features may change with version iterations. Interested users are encouraged to install and experience it further.

Enter the OneNav backend - Link Management - Bookmark Import to batch import browser-exported .html bookmarks into OneNav. Currently, it supports importing bookmarks from Chrome, Firefox, and Edge browsers.

Bookmark Import

In Category Management - Add Category, you can set Font Awesome 4 icons. Try setting the font icon to fa fa-book and then visit the frontend to see the effect. (More font icons can be selected at: https://fontawesome.dashgame.com/). By the way, if you set a category or link to private, unlogged-in users cannot see or access it.

Private Category

If you are using the default theme and logged in as an administrator, a "+" button will appear in the bottom right corner. Click it to quickly add a link.

Add Link

Hover over a link and click the right mouse button to pop up a context menu, allowing you to quickly edit, delete, display a QR code, copy the original link, etc.

Context Menu

If you don't like the default theme, no worries. User @baisu has created the baisuTwo theme (supported only for version 0.9.16 and later), which is now integrated into the OneNav project. You just need to modify data/config.php:

Change:

define('TEMPLATE','default');

To:

define('TEMPLATE','baisuTwo');

Then visit the frontend to see the effect: baisuTwo Theme

Both the default theme and baisuTwo theme use responsive layouts, displaying perfectly on PCs, tablets, and mobile phones.

Responsive PC

Responsive Mobile

Both themes also support bookmark search, making it easy to reach your destination quickly.

Search Demo

If you are a uTools user, you can also search for "OneNav" in the uTools plugin market to install the plugin, allowing you to use OneNav within uTools to further improve efficiency.

uTools Plugin

Conclusion

One article is not enough to introduce all of OneNav's features. For more details, please deploy and experience it yourself. The OneNav project has been active for over 2 years and is currently under active development. If you encounter any issues during use, you can provide feedback in my Xiaowen Community. Thank you for your support.