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
  • Open the current root directory in the local file manager

Bookmark Control Center Folders​

Choose Bookmarks to the right of the address bar, then Bookmark current folder. Select a bookmark to open its folder. Right-click a bookmark to rename or remove it. Script, resource, report, and enabled development folders can be bookmarked. You can also right-click a folder and choose Add to bookmarks. For bookmarked folders inside the development directory, choose Open project to open them in the editor.

Clients connected to the same control center share its folder bookmarks.

Properties and Folder Sizes​

In the control-center or device file list, right-click an item and choose Properties to view its name, location, modification time, and size. For a folder, click Calculate to total its size and count files and subfolders. You can also cancel or recalculate.

Calculations include hidden files and do not follow symbolic links. If some paths cannot be accessed, the panel shows the size counted so far and an incomplete-result notice. Click the notice to view the paths and reasons. A * in the list means the result is incomplete or needs recalculation; hover over it for details.

For global and app directories on a device, you can edit UID, GID, regular permissions, and special permission bits in Properties, then click Save permissions. For folders, you can choose to apply the changes recursively.

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 System 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.
  • Select the target devices, then right-click the package and choose the install option for their device type.

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.

Bookmark Device Folders​

Choose Bookmarks to the right of the address bar, then Bookmark current folder. Select a bookmark to open its folder. Right-click a bookmark to rename or remove it. You can also right-click a folder and choose Add to bookmarks.

Clients and device views on the same control center share bookmarks. A bookmark opens on the current device. Folders bookmarked from an app shortcut follow the app container on that device.