XZ

Xiao Z's blog

Learn, build, share

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

onenavbookmark managerself-hosted navigationopen source bookmarkphp sqlite
Published·Modified·

OneNav is a free, 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 for one deployment and access anywhere.

OneNav Interface

Features

  • Supports backend management
  • Supports private links
  • Supports batch 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 documentation 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 mount 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 supports Chrome, Firefox, and Edge browser bookmark imports.

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.

Category Settings

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.

Quick 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 problem. User @baisu has created the baisuTwo theme (supported only from version 0.9.16 onwards), which is now integrated into the OneNav project. You only need to modify data/config.php to 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, ensuring perfect display on PCs, tablets, and mobile phones.

Responsive PC

Responsive Mobile

Both the default theme and baisuTwo theme also support bookmark search, making it easy to reach your destinations quickly.

Search Demo

If you are a uTools user, you can also search for "OneNav" in the uTools plugin market to install the plugin, making it convenient to use within uTools and further improving 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.