Skip to content

About

A smart, completely portable Windows utility to securely purge accumulated OneDrive debug logs, reset stuck syncs, and redirect cache folders.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OneDrive Log Cleaner 🧹

Platform Language GUI

(English below | 中文说明在下方)


📸 Screenshots / 软件截图

image image


🇬🇧 English

OneDrive Log Cleaner is a defensive, fully portable Windows optimization engine designed to safely manage, purge, and redirect the heavy debugging logs and telemetry cache silently accumulated by Microsoft OneDrive.

It was engineered to solve a common headache for Windows users and professionals: OneDrive continuously dumping binary debugging fragments (ETL, ODL, LOG files) into the hidden AppData directory, which can rapidly consume dozens of GBs on your primary C-drive.

✨ Key Features

  • Defensive Whitelist Purging: Precision-cleans dead debugging logs (.log, .etl, .odl, etc.) without ever touching your actual work files or cloud data.
  • Smart Background Monitor: Sits silently in the system tray. Automatically purges junk the moment it exceeds your customizable threshold (e.g., 10GB).
  • Non-Destructive Sync Reset: Safely executes native commands to rebuild broken local sync hashes when OneDrive gets stuck on "Processing changes".
  • Seamless Folder Redirection: Uses NTFS junction points (mklink) to transparently move the heavy logs directory from C-drive to a secondary drive (D: or E:).
  • 100% Portable: No installation required. All configurations (app_config.json) and runtime logs are saved strictly in the program's folder.

🚀 Getting Started

  1. Go to the Releases page and download OneDriveLogCleaner_vX.X.exe.
  2. Run as Administrator (required to terminate file locks or create NTFS junction links).
  3. Click "Clean Onedrive log files" or toggle "Auto Clean" to let it guard your disk space.

🇨🇳 中文说明

OneDrive Log Cleaner 是一款专为彻底解决 OneDrive 长期运行导致 C 盘底层调试日志暴增、同步长期卡死等痛点而打造的 Windows 纯绿色全自动清理与调度引擎。

开发初衷是为了应对常见的 C 盘空间被无故占用的问题:OneDrive 会在深层目录下生成大量无法自动释放的二进制调试日志与遥测缓存碎片,悄无声息地吞噬数十 GB 的存储空间。

✨ 核心功能

  • 全量白名单防御级清理:严格基于扩展名精准抹除废旧日志碎片(.log, .etl, .odl 等),绝对不触碰您的任何实际工作文件与云端数据。
  • 后台静默空间卫士:常驻系统托盘。一旦检测到垃圾堆积超过设定阈值(如 10GB),立刻触发后台静默释放,完全免打扰。
  • 无损重置与账本重建:当 OneDrive 长期转圈卡死、提示“正在处理更改”时,可一键安全重置,静默顺畅重建本地文件指纹账本。
  • 底层目录无缝迁移:集成 NTFS 软链接技术,一键将极占空间的日志存放区从 C 盘定向挂载到 D 盘或 E 盘,治标且治本。
  • 极致绿色便携:真正的单文件便携设计,配置与日志均保存在程序同级目录下,无广告、无隐私采集。

🚀 如何使用

  1. 前往右侧的 Releases 页面,下载最新的 OneDriveLogCleaner_vX.X.exe。
  2. 双击运行程序(解除文件占用及创建软链接需管理员权限)。
  3. 点击“清除Onedrive log文件”即可瞬间释放空间;或勾选“自动清理”,让引擎常驻后台守护。

🛠 For Developers / 开发者指南

Option 1: Run from Source / 选项一:直接运行源码

pip install Pillow pystray
python "Onedrive Log Cleaner V1.0_Beta 1.py"

About

A smart, completely portable Windows utility to securely purge accumulated OneDrive debug logs, reset stuck syncs, and redirect cache folders.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages