Skip to main content

# File Management

The file manager is the main place for managing control-center assets. It works around three fixed root directories:

- `Script Directory`: runnable scripts, flat script folders, and related assets
- `Resource Directory`: general files, screenshots, installer packages, and other materials
- `Reports Directory`: batch authorization reports, exported schedule logs, and similar outputs

## Common Actions​

- Drag and drop a file, multiple files, or a full folder to upload
- Create a new file or folder
- Rename, copy, cut, paste, move, and delete
- Preview text and images, and edit text files directly in the UI
- View `MD5`, `SHA1`, `CRC32`, and line count information
- Open the current root directory in the local file manager

## Managing Script Assets​

- Flat scripts are best stored in `Script Directory`.
- Right-clicking a flat script folder or `.xpp` package folder lets you choose `Edit Script UI Configuration`; flat scripts maintain `lua/scripts/main.json`, while `.xpp` packages maintain root `main.json`.
- `.xxtlca` / `.xpa` script packages placed in `Script Directory` enter the install confirmation flow; `.xpa` installs as a `.xpp` package folder.
- If you need to update existing `XXTLanControl.lua` files inside scripts, use `Settings → Script Run Settings`.

## Send Files to Devices​

1. Select files in the file manager.
2. Click `Send to Devices`.
3. Choose the target devices and the target path on the device.

The panel includes several common target paths:

- `/lua/scripts/`
- `/lua/`
- `/res/`
- `/`

## Installer Package Distribution​

- `.deb` and `.tipa` packages are usually best stored in `Resource Directory`.
- When you right-click an installer package, the file manager shows installation actions based on the package suffix and the currently selected device types.

## Browse Device Files​

From the device list, you can open the file browser for a single device. There you can:

- browse files and folders on the device
- upload, download, move, and delete device files
- copy device files back into the control center's `Script Directory`, `Resource Directory`, or `Reports Directory`

This makes it easy to bring files back from devices, organize them, and redistribute them later.