---
title: roUsbFilesystem
slug: develop/rousbfilesystem
docTags: 
createdAt: 2025-03-26T17:59:49.919Z
---

This object allows supported BrightSign players to expose a local file as a USB mass storage device when connected to a USB host port on another device (for example, a PC or television.) The host acts as if it is talking to a USB thumb drive or USB hard drive, but the reads and writes go to the specified local file on the BrightSign. It requires a file containing a filesystem. One way to make such a file is:

```none
dd if=/dev/zero of=/storage/sd/test.img bs=4k count=2k
mkfs.vfat /storage/sd/test.img
```

Normally the local file would be prepared beforehand with a filesystem offline (any method that captures a raw copy of a filesystem should work).

BrightSign players with USB-C (except for LS3 and LS4) can use this object.

## ifUsbFilesystem

**Enable(filename As String) As Boolean**

Expose an existing filesystem image as a USB mass storage device.

**Disable() As Boolean**

Remove an existing filesystem image as a USB mass storage device.

## Examples

To create a filesystem (using the file from the example above):

```none
fs = CreateObject("roUsbFilesystem")
result = fs.Enable(

{filename: "SD:test.img"}

)
```

The result is a boolean. A result of `true` means that the filesystem has been successfully created.

## To remove a filesystem:

```none
result = fs.Disable()
```