OneDriveGUI

A simple GUI for Linux OneDrive Client, with multi-account support.

Feature highlights

• Management and configuration of multiple OneDrive accounts
• Asynchronous real-time monitoring of multiple OneDrive accounts
• Setup wizard for easy OneDrive profile creation and import
• Auto-sync on GUI startup
• Support for GUI based login process
• System tray (if supported by your desktop environment)
• Start minimized to tray/dock
• Input validation to prevent configuration of incompatible OneDrive client options
• Import and management of Business Shared Folders
• Import and management of SharePoint Shared Libraries
• ToolTips with brief explanation of various OneDrive Client configuration options.
• Prompt for re-sync authorization to prevent unexpected data loss.

Known Limitations

• No window shadows for Wayland sessions
• AppImage still requires the use of external browser for authentication
• Check for other reported issues/limitations.

Compatibility

• Minimum supported OneDrive client v2.4.15
• You will be shown warnings when your OneDrive Client is not up to date.

Other notes

• Questions, suggestions, contributions and bug reports are welcome.
• Backup your OneDrive config files before importing them to the GUI.
• Backup your data before use to prevent accidental file deletion due to OneDrive misconfiguration.
• No warranty.

Running and Installing OneDriveGUI

❗	Ensure the latest version of OneDrive for Linux is installed based on instructions for your distro.

AppImage

1. Download the latest OneDriveGUI-*-x86_64.AppImage from the release assets
2. Make the .AppImage file executable with chmod +x ./OneDriveGUI-<**version**>-x86_64.AppImage and run it.

📝	Users of Ubuntu 22.04+ may also need to install FUSE2 with sudo apt install libfuse2

AUR

• An AUR package onedrivegui-git is available. (maintainer: ZhangHua)

Running from source

1. Ensure Python3 and pip are installed on your system.

2. Clone or download content of this repository and cd into the resultant folder.

   git clone https://github.com/bpozdena/OneDriveGUI.git
   cd OneDriveGUI
   

3. Install dependencies:

   python3 -m pip3 install -r requirements.txt

4. Start OneDrive GUI:

   cd src/
   python3 OneDriveGUI.py

   Optionally, you can detach the GUI from terminal by using the bellow command:

   cd src/
   nohup python3 OneDriveGUI.py > /dev/null 2>&1&

Use

• Once the GUI starts, you will be able to create a new OneDrive profile or import your pre-existing one. Just follow the wizard steps.
• You can adjust your OneDrive profile options as needed.
• Start OneDrive sync in monitor mode via the GUI by pressing the Play button.

Additional Notes

• When importing OneDrive config file, all comments will be removed. Missing options will be replaced with default values.
• If multi-line options 'skip_file' and 'skip_dir' are used, they will be consolidated into a single line.
• List of managed OneDrive profiles is stored in ~/.config/onedrive-gui/profiles. You can manually rename your profile or path to config file there.
• Newly created OneDrive config files are stored in ~/.config/onedrive/accounts/<profile_name>
• Debug logs are saved in /tmp/onedrive-gui/onedrive-gui.log. Logging can be changed in the GUI settings.