Docs
Features
Multi-Device Sync

Multi-Device Sync

🔄
This guide describes a workaround for multi-device bookmark synchronization using existing GoSuki features and third-party tools. Native multi-device sync is not yet implemented in GoSuki.

Overview

GoSuki currently lacks built-in multi-device synchronization capabilities. However, you can achieve basic synchronization across devices using the following approach:

  1. HTML Autoimport feature to monitor bookmark files
  2. Third-party folder sync services like Syncthing
  3. Manual bookmark exports from mobile browsers

This method allows you to maintain consistent bookmarks across multiple devices, including desktops and mobile devices that cannot run GoSuki directly.

Setup Guide

1. Set Up Folder Synchronization

  1. Choose a sync directory (e.g., ~/shares/bookmarks)
  2. Install and configure Syncthing to synchronize this directory across all devices
  3. Add the directory to Syncthing on each device you want to sync

2. Configure GoSuki

Update your config.toml to monitor the synchronized directory:

[html-autoimport]
paths = ["$HOME/shares/bookmarks"]

Install Syncthing

Configure Syncthing

  1. Open Syncthing web interface (http://localhost:8384)
  2. Add the bookmarks directory as a new folder
  3. Share the folder with other devices using their device IDs

Set Up GoSuki

  1. Ensure html-autoimport is enabled in your config
  2. Restart GoSuki to apply changes

Export Bookmarks

On devices without GoSuki (e.g., mobile phones):

  1. Export bookmarks from your browser as HTML
  2. Save the file to the synchronized bookmarks directory
  3. Syncthing will automatically propagate the file to other devices

Usage

  • Desktop devices: GoSuki will automatically detect and import new/updated bookmarks
  • Mobile devices: Manually export bookmarks to the synchronized folder
  • Cross-device consistency: Changes made on any device will appear on all others after synchronization

Notes

  • Mobile limitations: GoSuki cannot run on mobile platforms, so manual exports are required
  • Conflict resolution: Last-write-win strategy - the most recent file in the sync directory takes precedence
  • File format: Use standard HTML bookmark format (e.g., Firefox’s “Bookmarks HTML Export”)

Best Practices

  • Regular exports: Set reminders to export bookmarks from mobile devices
  • Consistent structure: Maintain the same directory structure across all devices
  • Backup strategy: Consider keeping local backups of your bookmark files
Advanced Configuration

For more complex setups, you can:

  1. Use symbolic links to organize bookmarks by device
  2. Combine with automated export scripts for mobile devices

Limitations

  • No real-time synchronization (depends on Syncthing’s sync interval)
  • Requires manual intervention for mobile device bookmarks

This solution provides a functional workaround until native multi-device synchronization is implemented in future GoSuki releases. The community may also develop additional tools or plugins to enhance this functionality.

Html AutoimportDmenu - Rofi