Floccus

Sync your bookmarks across browsers via Nextcloud, WebDAV or Google Drive

📂 Sync any local bookmarks folder to any server-side folder
⚛ Use any browser that is compatible wit hthe web extension API
💼 Create as many sync profiles as you like
🚚 Control sync strategy, i.e. uni- or bidirectional syncing
⏳ Control sync interval
📦 Easily export your configuration
🔒 Keep your credentials secure with an encryption passphrase

Donate
Community
Install
- Nextcloud
- Chrome
- Firefox
- Android
- Permissions
Considerations
What's with the name?
Contributors
Contribute
Backers
Sponsors
License

Donate

If you'd like to support the creation and maintenance of this software, please consider donating. :)

Community

Talk to us on gitter or in the official Nextcloud Bookmarks talk channel! 👋

Install

The following sync methods are available:

Google Drive: If you have a Google account you can sync your bookmarks via an encrypted file in your Drive.
WebDAV: If you have a WebDAV server at hand, like any version of nextcloud/owncloud, box.com or with any other WebDAV server, commercial or self-hosted.
Nextcloud Bookmarks: Nextcloud in particular also sports a dedicated bookmarks app, which allows you to also access your bookmarks via a nice web UI.
Local file and more: You can also just sync with a local file, using the companion desktop app LoFloccus. You can then also sync that file to other computers using your favorite file syncing solution, like Dropbox, Syncthing, rsync, etc. You can also create a WebDAV Server on the local machine using Docker in GNU/Linux, check out the project Floccus-WebDavDocker.

Once your server or the LoFloccus app is ready, read on for the browser of your choosing.

Note: It is recommended to not enable native bookmark synchronization built into your browser, as it is known to cause issues.

Nextcloud

Floccus is regularly tested with the following setups:

Nextcloud	Bookmarks
v17	v1.1.2
v17	v2.3.4
v18	v2.3.4
v19	v3.4.3
v20	v4.x

Syncing via WebDAV should work with any Nextcloud version.

Chrome

You can install it via the Chrome Web store

Alternatively, you can still install it by downloading the Chrome package from the latest release and dropping it into Chrome's extension page.

Firefox

You can install it via AMO.

(Note that AMO has to review all new releases, though, so you might need to wait a bit before you can install the latest release on firefox.)

Android

Floccus is not supported by Firefox for Android yet. But, why wait for mozilla, if you can use Kiwi Browser, which supports floccus! Install instructions are the same as for Chrome.

Permissions

Floccus requests the following permissions:

Permission	Explanation
storage, unlimitedStorage	Necessary for maintaining a cache and mappings between server and browser bookmarks
alarms	Necessary for triggering synchronization in regular intervals
bookmarks	Necessary for creating and reading bookmarks
Unlimited web access	Necessary for accessing your self-hosted server. This cannot be limited, because everybody's server has a different URL. Unfortunately, the way webextensions work currently, floccus also gets access to all the data the browser has collected on those websites. However, floccus makes no use of that data and doesn't in any way collect information about you.

Limitations

Note that currently you cannot sync the same folder with multiple nextcloud accounts in order to avoid data corruption. If you sync the root folder with one account and sync a sub folder with a different account, that sub-folder will not be synced with the account connected to the root folder anymore.

Troubleshooting

Emojis: MySQL doesn't support emojis out of the box, so if you're syncing to nextcloud and getting Error code 500 from nextcloud, check the nextcloud log for SQL errors and proceed as explained in the nextcloud docs if you get charset errors.

If you need help sorting out problems, try the gitter chat room: https://gitter.im/marcelklehr/floccus

Considerations

Is this a good idea? I think so. If you'd like to know more, check out the considerations file

What's with the name?

Cirrus floccus is a type of cloud, that ~~can sync your browser data~~ looks very nice.

Contributors

This project exists thanks to all the people who contribute.

_{Bernd Wechner} 🐛 🤔 ⚠️	_jlbprof 💻 🐛 ⚠️	_TeutonJon78 🐛 🤔	_{Scott P.} 🐛 🤔	_Lantizia 🐛 🤔	_TCB13 💻 🤔 🔌 🌍	_gohrner 🐛
_Tank-Missile 🐛	_{Torsten Kurbad} 🐛	_gerroon 🐛

This project follows the all-contributors specification.

Contribute

All contributions, code, feedback and strategic advice, are welcome. If you have a question you can contact me directly via email or simply open an issue on the repository. I'm also always happy for people helping me test new features -- see the issues for announcements of beta versions.

Translating

Translations can now be provided over at transifex.

Development

Setting up a dev environment

Clone this repository.
Install node.js and npm
In the root of your floccus repo, run npm install && npm install -g gulp
Run gulp to build
Install firefox developer edition and prepare it as follows: https://developer.mozilla.org/en-US/Add-ons/Setting_up_extension_development_environment

Building

gulp

Releasing

gulp release

Backers

Thank you to all our backers! 🙏 [Become a backer]

C-Kenny/floccus