Skip to content

willowding/pcorganizer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PCOrganizer

Reclaim space on your C: drive without breaking a single game launcher.

PCOrganizer is a Windows PowerShell tool that moves games to whichever drive has the most free space, consolidates scattered AI assets (model weights, datasets, docs) onto a dedicated drive, and keeps game saves together with their games — all through NTFS junctions, so Steam / Epic / Battle.net / etc. keep working at their original paths with zero reconfiguration.

🔗 Homepage: https://willowding.github.io/pcorganizer/

中文:PCOrganizer 是一个 Windows PowerShell 工具,把游戏迁移到剩余空间最大的盘、 把散落各处的 AI 资料(模型权重 / 数据集 / 文档)归集到专用盘,并让游戏存档跟随游戏一起搬, 全程使用 NTFS 目录联接(junction)——启动器仍按原路径找到游戏,无需任何重新配置


Why / 为什么

C drive fills up fast, but moving a game the normal way breaks its launcher — the launcher loses the path. PCOrganizer moves the real files to another drive and leaves an NTFS junction at the original location, so every launcher still finds the game exactly where it expects it.

中文:C 盘很快塞满,但直接挪游戏会让启动器失联(路径变了)。PCOrganizer 把真实文件 搬到别的盘,在原位置留一个 junction,启动器照样能在原路径找到游戏。


Highlights / 功能亮点

  • Smart game detection — by launcher patterns (Steam / Epic / GOG / Riot / Battle.net / Ubisoft / EA / Xbox …), a size threshold, and white/blacklists.
  • Auto target selection — picks the destination drive with the most free space.
  • NTFS junctions — moved games stay launchable; no launcher reconfiguration.
  • Saves follow games — detected save folders are migrated alongside.
  • AI asset consolidation — gathers model weights, datasets and large doc sets (matched by file extension / directory keywords) onto a dedicated AI drive (a subst virtual drive, optionally upgradeable to a real partition).
  • Safety first — dry-run by default, a reviewable JSON plan, per-operation logs, and one-step rollback.
  • Auto UAC elevation — relaunches itself with admin rights when needed.

中文:智能识别游戏(按启动器路径 + 体积阈值 + 白/黑名单);自动选剩余空间最大的目标盘; 用 junction 保证迁移后仍可启动;存档跟随;AI 资料按后缀/关键词归集到专用盘; 默认 dry-run、可审核方案、操作日志、一键回滚;自动 UAC 提权。


Safety model / 安全机制

  • Dry-run by default — nothing moves until you pass -Apply.
  • Every run writes a plan_*.json / op_*.json into logs/ for review.
  • Rollback restores moves from the operation log.
  • The partition-upgrade action requires typing UPGRADE to confirm.

中文:默认只预览,不加 -Apply 不动任何文件;每次运行都在 logs/ 留下方案与操作日志; 可从日志回滚;升级真实分区需手动输入 UPGRADE 二次确认。


Quick start / 快速开始

# Preview only — dry-run (default, safe)
.\Organize-PC.ps1

# Actually move files
.\Organize-PC.ps1 -Apply

It opens an interactive menu (auto-elevates to admin):

# Action
1 Scan disks + files (build inventory)
2 Generate plan — dry-run report (plan.json)
3 Move games (with junctions + saves)
4 Consolidate AI assets + initialize the AI drive
5 Upgrade the AI drive to a real partition ⚠️
6 Rollback the last operation
7 View operation logs

中文:交互式菜单(自动提权)——1 扫描 / 2 生成方案 / 3 迁移游戏 / 4 归集 AI 资料 / 5 升级 AI 盘为真实分区 / 6 回滚 / 7 查看日志。建议先跑一次 dry-run 看方案再 -Apply


Configuration / 配置

All behavior is driven by config.psd1 — no need to touch the scripts:

  • Game target drives & priority
  • Launcher path patterns, size threshold, white/blacklist
  • AI model / dataset file extensions & dataset directory keywords
  • Save-file scan roots

中文:所有行为都由 config.psd1 控制(目标盘、启动器路径、体积阈值、白/黑名单、 AI 文件后缀与数据集关键词、存档扫描根目录),无需改动脚本本身。


Project structure / 项目结构

Path Purpose
Organize-PC.ps1 Orchestrator + interactive menu
config.psd1 All settings
modules/DiskScan.psm1 Disk / free-space inventory
modules/DetectGames.psm1 Game directory detection
modules/DetectAI.psm1 AI asset detection
modules/DetectSaves.psm1 Save-file detection
modules/Move-WithJunction.psm1 Move a directory + create the NTFS junction
modules/Setup-AIDrive.psm1 Set up / upgrade the AI drive
modules/Rollback.psm1 Undo operations from a log

Requirements / 运行环境

  • Windows with PowerShell 5.1+
  • Administrator rights (the script auto-requests UAC elevation)
  • NTFS source and target volumes (required for junctions)

中文:Windows + PowerShell 5.1 及以上;需要管理员权限(脚本会自动请求 UAC); 源盘与目标盘均需为 NTFS(junction 的前提)。


License

MIT — see LICENSE.

About

Intelligently move games to SSD/E-drive, organize AI assets, preserve save files — PowerShell + NTFS junctions, no launcher reconfiguration needed :3

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors