https://github.com/jlu5/bookmarksync

Manage, customize, and sync bookmarks for GTK+ and KDE
https://github.com/jlu5/bookmarksync

bookmarks gtk kde

Last synced: about 1 month ago
JSON representation

Manage, customize, and sync bookmarks for GTK+ and KDE

• Host: GitHub
• URL: https://github.com/jlu5/bookmarksync
• Owner: jlu5
• License: gpl-3.0
• Created: 2019-04-27T04:41:34.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-10-29T01:24:54.000Z (about 1 year ago)
• Last Synced: 2024-10-09T10:07:59.103Z (2 months ago)
• Topics: bookmarks, gtk, kde
• Language: C++
• Homepage:
• Size: 162 KB
• Stars: 11
• Watchers: 2
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# BookmarkSync

[![latest release](https://img.shields.io/github/v/tag/jlu5/bookmarksync?sort=date)](https://github.com/jlu5/bookmarksync/tags)

**BookmarkSync** is a simple program that manages the bookmarks (pinned folders) in GTK+, KDE, and Qt 5's native file pickers. I built this tool because I was using GTK+ apps (GIMP, Audacity, etc.) on KDE and constantly got frustrated by the bookmarks lists not matching up.

![Demo screenshot](bookmarksync.png "BookmarkSync main window")

Note: BookmarkSync is one solution to this problem, though there are other alternatives too that may work depending on the program, such as [xdg-desktop-portal](https://github.com/flatpak/xdg-desktop-portal) or setting `QT_QPA_PLATFORMTHEME=gtk2` on GTK+ based desktop environments.

## CLI mode

As of v0.3.0 there is support for running sync from the command line: `$ bookmarksync --sync-from {gtk,kde,qt}`.

Note that this is not truly headless, as BookmarkSync still expects a display to exist. If your environment doesn't have one available, you can switch to a dummy display with some QT overrides: `$ QT_QPA_PLATFORMTHEME= QT_QPA_PLATFORM=offscreen ./bookmarksync `

## Distribution packages

You can find bookmarksync in:

- Arch Linux AUR: [bookmarksync-git](https://aur.archlinux.org/packages/bookmarksync-git/)

- Debian via [Utopia Repository](https://deb.utopia-repository.org/): bookmarksync

## Build instructions

To compile BookmarkSync you will need qmake and the headers for KIO.

On Debian and derivatives, this is `apt install qtbase5-dev libkf5kio-dev`.

Then,

```shell

git clone https://github.com/jlu5/bookmarksync

cd bookmarksync/src

qmake

make -j$(nproc)

```

The resulting binary will be named `bookmarksync`.

Alternatively, you can build the project (`bookmarksync.pro`) using Qt Creator.

## Under the hood

- **GTK+** stores bookmarks in a simple plain text format at `~/.config/gtk-3.0/bookmarks`, which BookmarkSync manipulates as a plain text file.

- **KDE** stores bookmarks in XML form at `~/.local/share/user-places.xbel`. BookmarkSync uses [KFilePlacesModel](https://api.kde.org/frameworks/kio/html/classKFilePlacesModel.html) from KIO to edit these natively.

- **Qt** stores bookmarks in the Qt config file (INI format) at `~/.config/QtProject.conf`. BookmarkSync uses [QFileDialog](https://doc.qt.io/qt-5/qfiledialog.html#setSidebarUrls) methods (and hidden file dialog instances) to read and write to these.

### Known limitations

- Only KDE supports custom icons for places; syncing from others will erase all custom icons.

- Only GTK+ and KDE support remote locations like `sftp://` or `smb://` in bookmarks: syncing *from* Qt will remove all remote places from the list.

- Editing bookmarks from another program while BookmarkSync is running may cause things to go out of sync. This mainly affects the Qt backend, as the KDE and GTK+ backends tend to sync faster.