[!WARNING] OneDriveGUI v1.1.0 is only compatible with OneDrive client v2.5.0 . There is no backward compatibility with older OneDrive client versions. Please use OneDriveGUI v1.0.3 for OneDrive client v2.4.x .

[!IMPORTANT] If you are using sync_business_shared_folders in of OneDrive v2.4.0, you will need to manually remove it from the config file. Check the client documentation for more details.

[!NOTE] If your OneDrive client v2.5 is not installed system wide, you can manually define the path to the OneDrive binary in the GUI settings.

Example:

OneDriveGUI

About

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
• Progress monitoring of multiple simultaneous file transfers.
• 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
• No window icon when using AppImage on Wayland session
• AppImage still requires the use of external browser for authentication
• Check for other reported issues/limitations.

Compatibility

• Minimum supported OneDrive client v2.5.0
• 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 1) 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. 1) Clone or download content of this repository and cd into the resultant folder.

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

1) Install dependencies:

    python3 -m pip install -r requirements.txt

1) Start OneDrive GUI:

    cd src/
    python3 OneDriveGUI.py

Optionally, you can detach the GUI from terminal by using the bellow command:
```sh
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.
• 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.