Skip to content

bpozdena/OneDriveGUI

Repository files navigation

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:

image

OneDriveGUI

GitHub all releases

About

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

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

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

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