Repository navigation
Releases: bpozdena/OneDriveGUI
Release list
v2.4.0
OneDriveGUI v2.4.0 - release for the OneDrive client v2.5.12. Minimum supported client version is v2.5.11.
Warning
Two things to know before upgrading:
- Removed deprecated OneDrive client options (
force_http_2,min_notify_changes,sync_business_shared_folders) change the client's config hash, so OneDrive will ask for a one-time--resyncon the first start after the upgrade. This is expected - click Yes. - The application was re-packaged as a standard Python package. Third-party packages (AUR, etc.) will break until their maintainers update them - see the notes below.
What's Changed
Added
- Support for OneDrive client v2.5.12: the GUI now consumes
monitor-status.jsonas the authoritative high-level sync state, detects required resync from the client exit code, reports local Recycle Bin move failures, shows system clock drift warnings and understands the current deletion/rename wording #305 - New client options in profile settings:
skip_size,use_device_auth,permanent_delete#305 - 'Sign in with web browser' in the login dialog - the client opens the browser and receives the response itself, no URL copying #274
- New setting 'Stop OneDrive clients when OneDriveGUI exits' (enabled by default). Clients are stopped gracefully with SIGINT, so in-flight transfers complete #267
- OneDriveGUI detects a OneDrive client left running outside of the GUI and offers to take it over #267 #295
- Failed file syncs are now reported with the actual error and a desktop notification; failed transfers are collapsed behind a toggle in the profile view
- Free space shown in the system tray tooltip - good idea @ekolis #309
- New setting 'Remember window size and position' #280
- SharePoint site and library lists are now filterable, which helps with long lists #271
- GUI and client version checks retry every 60 seconds when the network is not yet available at startup, by @nikolainyegaard in #308
- Configurable maximum log file size (default 20 MB)
Fixed
- The frameless window's X button closed only the current profile page, leaving a blank window on screen - it now hides the window to the system tray, by @nchou-git in #313
- The client take-over check matched any process that merely mentioned the profile's configuration path in its command line (an editor,
tail -Fon the config file) and a sibling profile's client whose directory name started with this profile's - the GUI now takes over only the profile's own OneDrive client #314 - GUI crash when the resync/auth dialog was the last visible window #297
- Account type detection and persistence for SharePoint shared libraries, by @nikolainyegaard in #304 #271
- Tray icon click raises the unfocused window, by @nikolainyegaard in #302
- Autostart works when the executable is not on PATH, by @nikolainyegaard in #303
- 'Business Shared Folder has been deprecated' message shown without any business shared folders configured #287
- Broken symlinks now show the actual file system error #278
- Corrected tooltips of the advanced sync options #284
- AppImage failing to start with missing
libgthread-2.0.so.0#283 - Version checks compare versions numerically
- Operation timeout can be set above 99 seconds
Packaging
- OneDriveGUI is now a standard Python package, installable with pip and providing the
onedrive-guientry point, by @maikwoehl in #301 - The AppImage ships the app icon in the hicolor theme layout (16x16 to 256x256 under
apps/) and setsStartupWMClass, so GNOME (Wayland) shows the OneDriveGUI icon in the app grid and dock and matches the running window to its launcher entry #315
New Contributors
- @maikwoehl made their first contribution in #301
- @nikolainyegaard made their first contribution in #302
- @nchou-git made their first contribution in #313
Note for package maintainers
The source layout changed in v2.4.0. Packages that copy src/*.py and run OneDriveGUI.py directly will break - see #311 for details and advance discussion.
- All modules moved from
src/*.pyinto theonedrive_guipackage (src/onedrive_gui/). Runningpython3 src/OneDriveGUI.pyno longer works - the package must be imported, not executed as a script. - Preferred: build/install the wheel and ship the generated
onedrive-guiconsole script:
python3 -m pip install --no-deps --root=<pkgroot> onedrive_gui-2.4.0-*.whl
Use--no-depsand providePySide6(Essentials) andrequestsfrom your distribution, so pip does not install its own copies. - Alternative: copy the whole
src/onedrive_gui/directory to a location of your choice and launch withpython3 -m onedrive_gui(parent directory onPYTHONPATH). Resources resolve relative to the package, so the location is up to you. - The version now lives only in
src/onedrive_gui/options.py- the build reads it from there. - The
.uifiles are not shipped in the wheel, only the compiledui_*.pymodules. - Install the shipped
OneDriveGUI.desktop(it now includesStartupWMClass=OneDriveGUI) and the hicolor icon set so desktop environments find the icon.
Third-party package broken after upgrade? Workaround for users
- If you use the AUR
onedrivegui-gitpackage, consider switching to theonedriveguirelease package or the AppImage until the packaging change settles. The-gitpackage builds directly from themainbranch and will fail to build once v2.4.0 is merged, while the release package only changes when its maintainer bumps the version. - If your package updated with a dead launcher, you can fix it without root, and the fix survives package updates:
Adjust the paths if your package installs elsewhere. Just note that
mkdir -p ~/.local/bin printf '#!/bin/sh\nPYTHONPATH=/usr/lib/OneDriveGUI exec python3 -m onedrive_gui\n' > ~/.local/bin/onedrivegui chmod +x ~/.local/bin/onedrivegui mkdir -p ~/.local/share/applications sed 's/^Exec=.*/Exec=onedrivegui/' /usr/share/applications/onedrivegui.desktop > ~/.local/share/applications/onedrivegui.desktoppython3 OneDriveGUI.pyno longer works - the GUI must be started withpython3 -m onedrive_gui. - Or pin/downgrade your distro package to the previous version until the maintainer updates it.
- Or install into your user directory and run the
onedrive-guicommand (needs PySide6 and requests installed from your distribution):
python3 -m pip install --user --no-deps https://github.com/bpozdena/OneDriveGUI/archive/refs/tags/v2.4.0.tar.gz - Simplest of all: use the AppImage from this release.
v2.4.0 RC1
OneDriveGUI v2.4.0-RC1 - release candidate for the upcoming OneDrive client v2.5.12. Minimum supported client version stays v2.5.11. The final v2.4.0 will follow the official client release.
Warning
Two things to know before upgrading:
- Removed deprecated OneDrive client options (
force_http_2,min_notify_changes,sync_business_shared_folders) change the client's config hash, so OneDrive will ask for a one-time--resyncon the first start after the upgrade. This is expected - click Yes. - The application was re-packaged as a standard Python package. Third-party packages (AUR, etc.) will break until their maintainers update them - see the notes below.
What's Changed
Added
- Support for OneDrive client v2.5.12: the GUI now consumes
monitor-status.jsonas the authoritative high-level sync state, detects required resync from the client exit code, reports local Recycle Bin move failures, shows system clock drift warnings and understands the current deletion/rename wording #305 - New client options in profile settings:
skip_size,use_device_auth,permanent_delete#305 - 'Sign in with web browser' in the login dialog - the client opens the browser and receives the response itself, no URL copying #274
- New setting 'Stop OneDrive clients when OneDriveGUI exits' (enabled by default). Clients are stopped gracefully with SIGINT, so in-flight transfers complete #267
- OneDriveGUI detects a OneDrive client left running outside of the GUI and offers to take it over #267 #295
- Failed file syncs are now reported with the actual error and a desktop notification; failed transfers are collapsed behind a toggle in the profile view
- Free space shown in the system tray tooltip - good idea @ekolis #309
- New setting 'Remember window size and position' #280
- SharePoint site and library lists are now filterable, which helps with long lists #271
- GUI and client version checks retry every 60 seconds when the network is not yet available at startup, by @nikolainyegaard in #308
- Configurable maximum log file size (default 20 MB)
Fixed
- GUI crash when the resync/auth dialog was the last visible window #297
- Account type detection and persistence for SharePoint shared libraries, by @nikolainyegaard in #304 #271
- Tray icon click raises the unfocused window, by @nikolainyegaard in #302
- Autostart works when the executable is not on PATH, by @nikolainyegaard in #303
- 'Business Shared Folder has been deprecated' message shown without any business shared folders configured #287
- Broken symlinks now show the actual file system error #278
- Corrected tooltips of the advanced sync options #284
- AppImage failing to start with missing
libgthread-2.0.so.0#283 - Version checks compare versions numerically
- Operation timeout can be set above 99 seconds
Packaging
- OneDriveGUI is now a standard Python package, installable with pip and providing the
onedrive-guientry point, by @maikwoehl in #301
New Contributors
- @maikwoehl made their first contribution in #301
- @nikolainyegaard made their first contribution in #302
Note for package maintainers
The source layout changed in v2.4.0. Packages that copy src/*.py and run OneDriveGUI.py directly will break - see #311 for details and advance discussion.
- All modules moved from
src/*.pyinto theonedrive_guipackage (src/onedrive_gui/). Runningpython3 src/OneDriveGUI.pyno longer works - the package must be imported, not executed as a script. - Preferred: build/install the wheel and ship the generated
onedrive-guiconsole script:
python3 -m pip install --no-deps --root=<pkgroot> onedrive_gui-2.4.0-*.whl
Use--no-depsand providePySide6(Essentials) andrequestsfrom your distribution, so pip does not install its own copies. - Alternative: copy the whole
src/onedrive_gui/directory to a location of your choice and launch withpython3 -m onedrive_gui(parent directory onPYTHONPATH). Resources resolve relative to the package, so the location is up to you. - The version now lives only in
src/onedrive_gui/options.py- the build reads it from there. - The
.uifiles are not shipped in the wheel, only the compiledui_*.pymodules.
Third-party package broken after upgrade? Workaround for users
- If you use the AUR
onedrivegui-gitpackage, consider switching to theonedriveguirelease package or the AppImage until the packaging change settles. The-gitpackage builds directly from themainbranch and will fail to build once v2.4.0 is merged, while the release package only changes when its maintainer bumps the version. - If your package updated with a dead launcher, you can fix it without root, and the fix survives package updates:
Adjust the paths if your package installs elsewhere. Just note that
mkdir -p ~/.local/bin printf '#!/bin/sh\nPYTHONPATH=/usr/lib/OneDriveGUI exec python3 -m onedrive_gui\n' > ~/.local/bin/onedrivegui chmod +x ~/.local/bin/onedrivegui mkdir -p ~/.local/share/applications sed 's/^Exec=.*/Exec=onedrivegui/' /usr/share/applications/onedrivegui.desktop > ~/.local/share/applications/onedrivegui.desktoppython3 OneDriveGUI.pyno longer works - the GUI must be started withpython3 -m onedrive_gui. - Or pin/downgrade your distro package to the previous version until the maintainer updates it.
- Or install into your user directory and run the
onedrive-guicommand (needs PySide6 and requests installed from your distribution):
python3 -m pip install --user --no-deps https://github.com/bpozdena/OneDriveGUI/archive/refs/tags/v2.4.0RC1.tar.gz - Simplest of all: use the AppImage from this release.
OneDriveGUI v1.3.2
Warning
Minimum supported OneDrive client version is now v2.5.11. GUI v1.3.2 will refuse to run with older onedrive client versions - please upgrade your client before updating the GUI.
What's Changed
- Added support for onedrive v2.5.11's in-browser login flow, with a tray notification #296
- Added support for new onedrive v2.5.11 options: monitor authoritative sync, mirror local state, disable upload hash streaming #296
- Fixed logout not clearing credentials inside the AppImage
- Fixed config backup silently failing in some environments
- Fixed error messages only showing a generic line instead of the actual detail
- Fixed "official documentation" link on Selective Sync tab not being clickable
- Fixed the AppImage failing to start on some Linux distributions (
APPRUN_ERROR: No such file or directory) by building against Ubuntu 22.04 instead of 24.04 - Bumped bundled PySide6 to 6.11.1
OneDriveGUI v1.3.1
What's Changed
- Added a variable to track the real filename to avoid duplicates entries in case of long names by @dipusone in #279
- Use dynamic login URL based one onedrive config by @cielavenir in #286
- Fixed high CPU utilization when tray icon lives in Waybar #258
- Fixed progress bar when main window is closed #265 by @DoneWorkin
- Applied fix to missing icons of deleted files based on @DoneWorkin 's suggestion #266
- Ensure autostart works for both AUR packages
onedrivegui-gitandonedrivegui#276 - Applied @Velisariy’s fix for sync directory mounting with whitespaces #270
- Clear all warnings after a successful sync #264
- Enforce the minimum version of onedrive client to be 2.5.10 to prevent login issues
- Fix missing
CRITICALlogging level in GUI settings. - Add Docker-based AppImage builder script based on #286
New Contributors
- @dipusone made their first contribution in #279
- @cielavenir made their first contribution in #286
- @DoneWorkin made their first contribution in #265 and #266
- @Velisariy made their first contribution in #270
OneDriveGUI v1.3.0
New Features and Enhancements:
-
Add option to start OneDriveGUI AppImage automatically after login. It will also work when installed via package managers if you ensure it is available under name
OneDriveGUI(case-sensitive).

-
Enhance file transfer UI with timestamp display #97

-
The GUI now shows a list of files that failed to sync. The user will still need to check the log file to identify the root cause.

-
System Tray now shows the client status (error, stopped, etc.)

-
Updated icons
-
Implement OneDriveGUI version check #255

-
Detect sync completion initiated by WebSocket notification #244
-
Added support for Display Manager Integration #252

-
Add cleanup local files option to profile settings #200
-
Add option to disable Version Check performed by the client #254
-
Add options to Disable WebSocket Support #253

-
Various improvements to error handling and messaging #255

-
Add error handling and messaging for unknown keys in client's configuration file



Bug Fixes:
- Fix non-working sync after big delete
- Fix missing resync dialog when full-resync is enabled in the config
- Fix detection of already running onedrive process #255
OneDriveGUI v1.2.2
What's Changed
- fix: Repetitive login requests #240
- fix: Crashes after a while when uploading large amount of files #208
- fix: "Save" button labelled as Login #241
- Update ui_profile_settings_page.py by @jerm00 in #232
- potential fix: window icon under Wayland by @Integral-Tech in #214
- fix: .desktop file by @Integral-Tech in #215
- docs(README): update AUR maintainer by @Integral-Tech in #237
New Contributors
- @jerm00 made their first contribution in #232
- @Integral-Tech made their first contribution in #214
Full Changelog: v1.2.1...v1.2.2
OneDriveGUI v1.2.1
OneDriveGUI v1.2.0
Warning
OneDriveGUI v1.2.0 is only compatible with OneDrive client v2.5.6+ . There is no backward compatibility with older OneDrive client versions.
Please use OneDriveGUI v1.1.1 with OneDrive client v2.5.0-2.5.5 or OneDriveGUI v1.0.3 for OneDrive client v2.4.x .
Changes
- Complete code restructure. (This may have introduced new bugs I haven't caught — please report any issues.)
- Added a 5-second delay to the re-sync dialog to prevent accidental approval.
- Fixed login issues with OneDrive client v2.5.6.
- Fixed links to the OneDrive client documentation.
- Added compatibility for new features introduced in OneDrive client v2.5.6:
- Option to use a local recycle bin or trash folder.
- Option to always use session uploads for better support of applications that use atomic save operations.
- Configurable upload delay, intended to support Obsidian.
Enable recycle bin:
More details about the feature can be found on in the client documentation: Using local Recycle Bin

Example of files moved to Trash directory:

Enable inotify delay for Obsidian documents:
More details about the feature can be found on in the client documentation: Compatibility with Obsidian

Re-sync confirmation delay
OneDriveGUI v1.1.1
Warning
OneDriveGUI v1.1.1 is only compatible with OneDrive client v2.5.x .
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 config of OneDrive v2.4, 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. Check the readme for details.
Changes
- Add a scrollbar on sync option page #188 for better compatibility with small screens
- Show the version of OneDriveGUI in logs and in main window title #187
- Main window can now resized freely for better compatibility with small screens, allow corner snapping, etc.
- Add scrollbar in GUI Settings window
- Minor layout changes in the profile settings
- Potential fix for AUR users
v1.1.0
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 config of OneDrive v2.4, 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. Check the readme for details.
Changes
- Provides compatibility with new features introduced in OneDrive client v2.5.0 .
- Added support for multi-threaded upload/download progress monitoring.
- Removed GUI based configuration of Business Shared Folders.
- Various bug fixes and small visual improvements.
