Browser Import - Organizr Plugin

A powerful plugin for Organizr that allows you to bulk import bookmarks and browser tab groups from Chrome, Firefox, Edge, and other browsers into Organizr's bookmark system or as regular tabs.

Features

• Bookmark Import: Import bookmarks from Chrome (HTML), Firefox (JSON), and Edge (HTML) formats
• Tab Group Import: Import Chrome tab groups from extensions like Tab Groups Exporter, Session Buddy, Tab Session Manager, and Toby
• Flexible Import Options:
  • Import as Bookmark Tabs (requires Bookmark plugin)
  • Import as Regular Organizr Tabs
• Smart Organization:
  • Automatically create categories based on bookmark folders
  • Preserve bookmark structure and organization
  • Skip duplicate bookmarks
• User-Friendly Interface:
  • Choose default category and user group for imported bookmarks
  • Create new categories on the fly
  • Progress tracking and detailed import results
• Bulk Operations: Clear all bookmarks with a single click

Prerequisites

• Organizr v2
• PHP 7.4 or higher
• Database access (SQLite or MySQL)
• Bookmark plugin enabled (if importing as bookmark tabs)

Installation

1. Clone or download this repository
2. Copy the bookmarkImporter folder to your Organizr installation:

   Organizr/api/plugins/bookmarkImporter/
   

3. Ensure the Bookmark plugin is enabled in Organizr settings (if importing as bookmark tabs)
4. Enable the Browser Import plugin in Organizr settings

Usage

Importing Bookmarks

1. Export bookmarks from your browser:

   • Chrome/Edge: Go to chrome://bookmarks/ or edge://favorites/, click the three dots menu, select "Export bookmarks"
   • Firefox: Go to Library (Ctrl+Shift+B), click "Import and Backup" > "Backup..." to save as JSON

2. Access the plugin:

   • Go to Organizr Settings
   • Navigate to Plugins
   • Click Settings for "Browser Import"

3. Import your bookmarks:

   • Click "Choose File" and select your exported bookmark file
   • Select "Import As" (Bookmark Tabs or Regular Organizr Tabs)
   • (Optional) Select a default category and user group
   • (Optional) Select tab type (for regular tabs: iFrame, New Window, or Organizr)
   • Click "Import Bookmarks"

Importing Chrome Tab Groups

1. Export tab groups:

   • Install a Chrome extension like Tab Groups Exporter
   • Export your tab groups as JSON

2. Import tab groups:

   • In the Browser Import plugin settings, scroll to "Chrome Tab Groups Import"
   • Upload the JSON file
   • Select which tab group to import
   • Choose import options (Import As, Group, Tab Type)
   • Click "Import Tab Group"

Plugin Structure

bookmarkImporter/
├── plugin.php      # Main plugin class and logic
├── api.php         # API routes for the plugin
├── config.php      # Default configuration
├── settings.js     # Frontend JavaScript for settings page
├── main.js         # Main JavaScript file (loaded on page load)
└── Browser_import.png  # Plugin logo

API Endpoints

• GET /api/v2/plugins/bookmarkimporter/settings - Get plugin settings page
• GET /api/v2/plugins/bookmarkimporter/categories - Get available bookmark categories
• GET /api/v2/plugins/bookmarkimporter/regular-categories - Get available regular categories
• POST /api/v2/plugins/bookmarkimporter/import - Import bookmarks from file
• POST /api/v2/plugins/bookmarkimporter/import-tabgroup - Import tab group from JSON
• DELETE /api/v2/plugins/bookmarkimporter/clear - Clear all bookmarks

Supported Formats

Bookmark Formats

• Chrome HTML bookmarks
• Firefox JSON bookmarks
• Edge HTML bookmarks

Tab Group Formats

• Tab Groups Exporter format
• Session Buddy format
• Tab Session Manager format
• Toby format
• Simple array/object formats

Development

The plugin follows Organizr's plugin development guidelines. Key files:

• plugin.php: Contains the main BookmarkImporter class extending Organizr
• api.php: Defines Slim framework routes for the plugin API
• config.php: Default configuration values
• settings.js: JavaScript for the settings UI

Troubleshooting

• Plugin not showing up: Make sure the Bookmark plugin is enabled first (if importing as bookmark tabs)
• Import fails: Check that the bookmark file format is supported (Chrome HTML or Firefox JSON)
• Bookmarks not appearing: Verify the Bookmark plugin is enabled and the bookmark tab exists (if importing as bookmark tabs)
• Tab groups not importing: Ensure the JSON file is from a supported extension format

License

GPL-3.0 (same as Organizr)

Credits

Built for Organizr - HTPC/Homelab Services Organizer