Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -388,3 +388,10 @@ varmanager_flutter/app.*.map.json
varmanager_flutter/android/app/debug
varmanager_flutter/android/app/profile
varmanager_flutter/android/app/release
CLAUDE.md
AGENTS.md
SharpVaMTools/

# External link files (not distributed with build)
data/links/
data/aria2c.exe
1 change: 0 additions & 1 deletion Custom/Scripts/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,6 @@ This directory contains C# scripts designed to run inside **Virt-A-Mate (VaM)**
These scripts are maintained as part of the varManager project:
- **Main Repository:** https://github.com/bustesoul/varManager
- **LoadScene Library:** `../../LoadScene/src/`
- **Archived C# Project:** `../../_archived/varManager/Custom/Scripts/`

## Note

Expand Down
18 changes: 8 additions & 10 deletions PROJECT_STRUCTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ varManager/
├── README.md # Main documentation
├── README_CN.md # 中文文档
├── PROJECT_STRUCTURE.md # This file
├── data/
│ └── links/ # External link files (gitignored)
│ ├── *.txt # Var package download links (537 files)
│ ├── torrents/ # Torrent files (78 files)
│ └── README.md # Usage instructions
├── varmanager_flutter/ # Flutter frontend (Dart)
│ ├── lib/
│ │ ├── app/ # App shell, theme, routing
Expand Down Expand Up @@ -49,12 +54,6 @@ varManager/
├── MMDLoader/ # Standalone WPF tool (optional)
│ └── *.xaml, *.cs # WPF application
└── _archived/ # Legacy C# WinForms code (v1.0.4.x)
├── varManager/ # Old main program
├── DragNDrop/ # Old custom controls
├── StarRatingControl/
├── ThreeStateTreeView/
└── ... # For reference only
```

## Technology Stack
Expand Down Expand Up @@ -121,22 +120,21 @@ varManager_v2.0.0/
|-----------|--------|-------------|---------|
| `varmanager_flutter/` | ✅ Active | Yes | Main UI |
| `varManager_backend/` | ✅ Active | Yes | Backend service |
| `data/links/` | ✅ Active | No (gitignored) | External download link database |
| `Custom/Scripts/` | ✅ Active | Yes | VaM plugins |
| `LoadScene/` | ✅ Active | Yes | Plugin library source |
| `MMDLoader/` | ⚠️ Optional | Yes | Standalone tool |
| `_archived/` | 📦 Legacy | Yes | Old C# code |

## Documentation

- **README.md** - Main documentation (English)
- **README_CN.md** - 中文文档
- **PROJECT_STRUCTURE.md** - This file
- **Custom/Scripts/README.md** - VaM plugin guide
- **_archived/README.md** - Legacy code reference

## Notes

1. **VaM Plugins:** Source files committed to Git, no compilation needed
2. **config.json:** Generated on first run, not stored in the repository
3. **_archived/:** Historical reference, not part of active development
4. **LoadScene/MMDLoader:** Source available for manual building if needed
3. **LoadScene/MMDLoader:** Source available for manual building if needed
4. **data/links/:** Contains real link files for external download sources (Pixeldrain, Mediafire, torrents). Gitignored to avoid committing third-party URLs. Ready to use without copying.
39 changes: 37 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,7 @@ varManager_v2.0.0/
├── varManager.exe # Main application (Flutter)
├── data/ # Runtime data and backend
│ ├── varManager_backend.exe # Backend service (Rust)
│ ├── aria2c.exe # Torrent downloader (required for torrent downloads)
│ ├── flutter_windows.dll # Flutter runtime
│ ├── *_plugin.dll # Plugin DLLs
│ └── flutter_assets/ # Flutter assets
Expand Down Expand Up @@ -105,6 +106,41 @@ The varManager backend has built-in support for downloading var packages directl
- Handles authentication with VaM Hub automatically
- Configure your VaM Hub credentials in Settings when first using the download feature

**External Download Sources (Advanced):**

varManager can search for missing var packages from external sources (Pixeldrain, Mediafire) and local torrent files as a fallback when Hub doesn't have them:

1. **Link Files Setup:**
- Create a `data/links/` folder in your varManager directory
- Add `.txt` files containing var package links (one per line)
- Format: `VarName.var [whitespace] URL`
- Example: `Creator.PackageName.1.var https://pixeldrain.com/u/ABC123`

2. **Torrent Files Setup:**
- Create a `data/links/torrents/` subfolder
- Place `.torrent` files that contain var packages
- The scanner detects var names in torrent metadata and can download missing vars via aria2

3. **Pre-populated Link Files:**
- The repo includes working link files in `data/links/` folder (gitignored)
- These are real, curated link databases ready to use
- Files are included in the repository but not in public releases

4. **Usage:**
- Go to Missing Vars page
- Enable "External Sources" checkbox
- Select desired sources (Pixeldrain, Mediafire)
- Click "Fetch Links (Hub + External)"
- Hub results always take priority; external sources fill gaps

**Torrent Downloads (aria2):**
- Place `aria2c.exe` in `data/aria2c.exe`
- When a missing var has torrent hits and no direct URL, varManager uses aria2 to download only the required `.var` files
- Downloads go to `varspath\AddonPackages\tmp` and completed `.var` files are moved to `varspath`
- `.torrent` files in `data/links/torrents/` are never deleted

**Note:** Link files in `data/links/` are gitignored and not included in public releases. Clone the full repository to access them.

**No Additional Runtime Required:**
- ❌ No .NET Runtime installation needed
- ❌ No administrator rights required (for normal operations)
Expand All @@ -126,10 +162,9 @@ The varManager backend has built-in support for downloading var packages directl

#### What Happened to the C# Version?

The legacy C# WinForms application (v1.0.4.x) has been **archived** to the `_archived/` folder for reference. All functionality has been migrated to the new Flutter + Rust architecture with feature parity and improvements.
The legacy C# WinForms application (v1.0.4.x) has been retired. All functionality has been migrated to the new Flutter + Rust architecture with feature parity and improvements.

**If you need the old C# version:**
- You can find it in the `_archived/varManager/` directory
- Requires .NET 9.0 Runtime
- No longer actively maintained

Expand Down
39 changes: 37 additions & 2 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,7 @@ varManager_v2.0.0/
├── varManager.exe # 主程序(Flutter)
├── data/ # 运行时数据和后端
│ ├── varManager_backend.exe # 后端服务(Rust)
│ ├── aria2c.exe # Torrent downloader (required for torrent downloads)
│ ├── flutter_windows.dll # Flutter 运行时
│ ├── *_plugin.dll # 插件 DLL
│ └── flutter_assets/ # Flutter 资源
Expand Down Expand Up @@ -105,6 +106,41 @@ varManager 后端内置了从 VaM Hub 下载 var 包的支持:
- 自动处理 VaM Hub 身份验证
- 首次使用下载功能时在设置中配置 VaM Hub 凭据

**外部下载源(高级功能):**

varManager 可以从外部源(Pixeldrain、Mediafire)和本地种子文件搜索缺失的 var 包,作为 Hub 的补充:

1. **链接文件设置:**
- 在 varManager 目录下创建 `data/links/` 文件夹
- 添加包含 var 包链接的 `.txt` 文件(每行一个)
- 格式:`VarName.var [空格或制表符] URL`
- 示例:`Creator.PackageName.1.var https://pixeldrain.com/u/ABC123`

2. **种子文件设置:**
- 创建 `data/links/torrents/` 子文件夹
- 放置包含 var 包的 `.torrent` 文件
- 扫描器会检测种子元数据中的 var 名称(仅供参考)

3. **预置链接文件:**
- 仓库中包含可用的链接文件,位于 `data/links/` 文件夹(已加入 gitignore)
- 这些是真实的、经过整理的链接数据库,可直接使用
- 文件包含在仓库中,但不包含在公开发布版本中

4. **使用方法:**
- 进入缺失 Var 页面
- 勾选 "Enable External Sources"(启用外部源)
- 选择所需的源(Pixeldrain、Mediafire)
- 点击 "Fetch Links (Hub + External)"(获取链接)
- Hub 结果始终优先,外部源用于补充

**Torrent Downloads (aria2):**
- 放置 `aria2c.exe` 到 `data/aria2c.exe`
- 当没有直链但有 torrent 命中时,使用 aria2 只下载所需 `.var`
- 下载路径 `varspath\AddonPackages\tmp`,完成后移动到 `varspath`
- `data/links/torrents/` 下的 `.torrent` 不会被删除

**注意:** `data/links/` 中的链接文件已加入 gitignore,不会包含在公开发布版本中。需要克隆完整仓库才能访问。

**无需额外运行时:**
- ❌ 无需安装 .NET Runtime
- ❌ 无需管理员权限(正常操作)
Expand All @@ -126,10 +162,9 @@ varManager 后端内置了从 VaM Hub 下载 var 包的支持:

#### C# 版本去哪了?

旧版 C# WinForms 应用程序(v1.0.4.x)已被**归档**到 `_archived/` 文件夹供参考。所有功能已迁移到新的 Flutter + Rust 架构,并保持功能对等和改进。
旧版 C# WinForms 应用程序(v1.0.4.x)已停止维护。所有功能已迁移到新的 Flutter + Rust 架构,并保持功能对等和改进。

**如果你需要旧版 C# 程序:**
- 可在 `_archived/varManager/` 目录中找到
- 需要 .NET 9.0 Runtime
- 不再积极维护

Expand Down
58 changes: 0 additions & 58 deletions _archived/DragNDrop/AssemblyInfo.cs

This file was deleted.

Loading