Skip to content

Latest commit

 

History

History
88 lines (60 loc) · 5.06 KB

README.md

File metadata and controls

88 lines (60 loc) · 5.06 KB
Raw

UBsync

UBsync is the featured application for OwnCloud/Nextcloud synchronization on Ubuntu Touch.

OpenStore

Weblate Translation Status

Common UBsync Recommendations

  • Do not synchronize the entire home folder, because it can be quite big and certain fast-evolving files (caches, or profiles) may induce many file versions in the cloud. Rather set up several targets and select individual folders.
  • UBsync can be used to back up your app configs to Owncloud/Nextcloud
  • Application sync support tips:
    • UBsync can be used to sync Activity Tracker app and Nextcloud GPXedit
    • UBsync can be used to sync Crazy Mark app with Nextcloud Notes
    • UBsync can be used to sync your music files
    • ...

Upgrade/Post-Install Recommendations

  • Reboot your phone after installation - backend daemon is started by upstart and will be properly initialized when you log out and log in, the simpler way is probably to reboot your phone

App Permissions

UBsync requests explicitly following permissions:

  1. Online Accounts - to be able to use Owncloud/Nextcloud accounts already set up in system settings
  2. Networking - as a cloud synchronization app, it naturally needs network access

Additionally, UBsync is an unconfined app, which means, that it is not limited by any AppArmor security policies. This application needs to be unconfined, as the pre-defined AppArmor policies do not permit all of UBsyncs' vital features:

  1. gain read/write access to any folder you wish to synchronize
  2. create the backend daemon (Owncloudsyncd) by upstart for background synchronisation
  3. UBsync-ui to Owncloudsyncd communication through DBUS

As unconfined apps may introduce security risks, you can review the app's source code or even build the app by yourself to be sure, that the app is not harmful.

Please note, that unconfined applications in OpenStore are manually reviewed.

To get the source code, go to GitHub to download and review the UBsync source code.

To build the app, install Clickable (v7.0.0 or above), open a terminal, clone the UBsync repo, change into the UBsync folder and run clickable.

Project History

UBsync was originally forked from ownCloud-sync, a dedicated Nextcloud application for Ubuntu touch, supported by UBports.

This repository continues, where UBsync Launchpad Project finished.

This fork was originally created as a reaction to the discussion at forums.ubports.com related to missing arm64 support for UBsync.

Later the development was returned to Launchpad for a short period. After discussions in the developers/testers community (12/2021 - since version 0.7), the development was moved to GitHub, as GitHub remains one of two major platforms, where UBports community lives and Github-centric development is more comfortable for current maintainers.

Code evolution is briefly documented in the changelog.

Credits

We would like to thank several projects/persons:

  1. ownCloud-sync application,
  2. Nextcloudcmd, a Nextcloud client,
  3. qWebdavlib a Qt library for WebDAV,
  4. Joan CiberSheep for the icon using Suru Icon Theme elements

Current and Past Contributors

Contribute

Please use the issue tracker to report a bug or request a new feature. Any help on the code is welcomed to enhance the app!

Translations

For translation instructions please read this page from the docs.

This app currently uses the Weblate translation service.

Alternativelly, you can create or edit the .po file for your language and commit this new/changed .po file as a pull request.

Documentation