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

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.

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 pip 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.