#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/case-studies.mdx:1
#, no-wrap
msgid "9"
msgstr ""
#. type: Title #
#: docs/case-studies.mdx:4
#, no-wrap
msgid "Use Cases"
msgstr ""
#. type: Title ###
#: docs/case-studies.mdx:6
#, no-wrap
msgid "1. Digital Security training to distribute apps and materials"
msgstr ""
#. type: Plain text
#: docs/case-studies.mdx:11
#, no-wrap
msgid ""
"> Leaders from Southern Africa countries travel to provide training, audits, and consultations to organizations about digital security, physical safety, risk assessments, and to equip journalists, activists and human rights defenders with the tools and knowledge to do their job safer. In order to do their work effectively, these leaders need to be able to curate specific types of content to fit various use cases, in different contexts and languages and different formats. In offline situations (load shedding, no access to the internet or in times of internet shutdowns) the ability to successfully deliver trainings and content becomes almost impossible. \\\n"
"> \\\n"
"> They shared more than a few times that if they did not have the Butter Box, some sessions would have been canceled.\n"
msgstr ""
#. type: Title ###
#: docs/case-studies.mdx:12
#, no-wrap
msgid "2. Sharing & Media Backup"
msgstr ""
#. type: Plain text
#: docs/case-studies.mdx:15
#, no-wrap
msgid "> Often M. wants to share music and movie files that theyve downloaded on their computer with their friends but transferring with cables or Bluetooth is a pain. So they've set up a Butter Box with their media collection music files, films and photos. They plugged it in near the kitchen, and now anyone in their apartment can connect to the Butter WiFi and browse a shared media library. No internet needed, and no more file-by-file transfers.\n"
msgstr ""
#. type: Title ###
#: docs/case-studies.mdx:16
#, no-wrap
msgid "3. Temporary file storage"
msgstr ""
#. type: Plain text
#: docs/case-studies.mdx:18
#, no-wrap
msgid "> On a remote site with no cell service, workers needed a way to temporarily offload large files like site photos or documents from their phones. Using Butter Boxs local encrypted message board, they sent files to themselves or coworkers for safekeeping. Files stayed on the device until retrieved later, even without power or signal.\n"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
"_If this page does not load, wait a few minutes to ensure connectivity. "
"Refresh the page. If youre connecting from a smartphone, turn off your "
"mobile data or turn on airplane mode. Then try again._"
msgstr ""
#. type: Fenced div block (info)
#: docs/quick-start.mdx:56
#, no-wrap
msgid "This is an HTTP page, not HTTPS, because it's served from a local device with no internet connection. Your data never leaves the network, so it's still private and secure.\n"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:61
msgid ""
"The Wi-Fi does not have a password by default. Though, you can easily add "
"one in the Admin Settings."
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:62
#, no-wrap
msgid "Once connected, use Admin Settings to set up your box."
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:65
msgid ""
"The admin setup wizard is designed to give you choice over which services "
"are offered on the box and to increase its security. You will be prompted to "
"go to Admin Settings if this is the first time you've used the box."
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:66
#, no-wrap
msgid "Share access to the portal"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:69
msgid ""
"Once you share with others, they will connect to it in the same way you just "
"did."
msgstr ""
#. type: Fenced div block (info)
#: docs/quick-start.mdx:70
#, no-wrap
msgid ""
"For a Pi Zero 2 W: Up to 5 people can connect to the box at any time. After people connect and get what they need, encourage them to leave the box to give others a turn.\\\n"
"The physical reach of the Box varies. But as a rule of thumb, people in the same room as the box (or in talking distance) will be able to access it.\n"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/update-butter.mdx:1
#, no-wrap
msgid "6"
msgstr ""
#. type: Title #
#: docs/update-butter.mdx:4
#, no-wrap
msgid "Update Butter"
msgstr ""
#. type: Title ###
#: docs/update-butter.mdx:6
#, no-wrap
msgid "Check out new releases from the Butter Box team"
"| <p><strong>Basic</strong> </p><p>Raspberry Pi Zero Pi 2<br/><br/><a href=\"raspberry-pi/basic-box-supplies\">Get Started</a></p> | Up to 10 people, About 10 meters apart | [Supply List](raspberry-pi/basic-box-supplies) |\n"
"| <p><strong>Extended</strong> </p><p>Raspberry Pi 4 + Router<br/><br/><a href=\"raspberry-pi/extend-your-box\">Get Started</a></p> | Up to 20 people, About 30 meters apart when paired with a router | [Supply List](raspberry-pi/extend-your-box) |\n"
msgid "<figure><img src=\"/img/docs/Screenshot 2026-02-24 at 9.56.27AM.png\" alt=\"\"/><figcaption><p>Select Raspberry Pi Zero 2 W (or the device you have if it's not the standard box from Butter HQ)</p></figcaption></figure>\n"
msgid "<figure><img src=\"/img/docs/Screenshot 2026-02-24 at 9.57.31AM.png\" alt=\"\"/><figcaption><p>Select Use Custom. You will upload the custom .img file that you downloaded from Dropbox.</p></figcaption></figure>\n"
msgid "<figure><img src=\"/img/docs/Screenshot 2026-02-24 at 1.27.43PM.png\" alt=\"\"/><figcaption><p>Final screen after selections.</p></figcaption></figure>\n"
"The best way to get started with creating your own content pack is to have "
"an idea about the experience and type of information you want to provide, "
"and then to design and build a local static website for it."
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:34
msgid ""
"It can be very simple like an audio player for music. Or, a simple list of "
"the five top VPN apps that you recommend. Or it can be more complex like a "
"library or knowledge base of cultural artifacts."
msgstr ""
#. type: Title ###
#: docs/content-packs/index.mdx:37
#, no-wrap
msgid "Add website files to a USB drive"
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:40
msgid ""
"Place a folder with your website files in the **root directory** of a USB "
"drive. Be sure that your website folder contains your **index.html.** The "
"name of this folder will be displayed on the Butter Box portal."
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:42
#, no-wrap
msgid "<figure><img src=\"/img/docs/Screenshot 2025-08-16 at 9.46.16 PM.png\" alt=\"\"/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>\n"
"Insert the USB drive into your Butter Box. When you open the Butter Box "
"portal, tap **Files**. Navigate to the website folder. Tap to view."
msgstr ""
#. type: Title #
#: docs/content-packs/maps.mdx:4
#, no-wrap
msgid "Maps"
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:7
msgid ""
"You can make offline maps available from your Butter Box. These maps are "
"powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android."
msgstr ""
#. type: Fenced div block (warning)
#: docs/content-packs/maps.mdx:8
#, no-wrap
msgid "**Important:** Offline map downloads work **only on Android devices**. iOS is not supported.\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/maps.mdx:12
#, no-wrap
msgid " Steps to Enable Maps"
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:15
#, no-wrap
msgid "**1. Download the map files you need**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:18
msgid ""
"Visit: [OsmAnd Local Indexes List](https://osmand.net/list?"
"sortby=size\\&asc=false)"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:18
msgid "Choose and download the regions you want available offline."
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:20
#, no-wrap
msgid "**2. Organize your files**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:23
msgid "On your USB drive, create a folder named `osm-map-files` ."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:23
msgid "Put the **OsmAnd APK** and all your **map files** into this folder."
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:25
#, no-wrap
msgid "<figure><img src=\"/img/docs/Screenshot 2025-08-16 at 9.44.40 PM.png\" alt=\"\"/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:27
#, no-wrap
msgid "**3. Add to your Butter Box**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:30
msgid "Insert the USB drive into your Butter Box."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:30
msgid ""
"The **Offline Maps** tile will automatically appear in your Butter Box "
"portal."
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:32
msgid ""
" Thats it anyone using an **Android device** can now download OsmAnd and "
"the offline maps youve provided directly from your Butter Box."
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:33
msgid ""
"Note: The OSM map apk is available on the Butter Box software image. Updates "
"to the OsmAnd app will be available with new releases of the Butter Box "
"software. If you want to know what the latest available version of OsmAnd "
"app is, visit [OsmAnd Free Releases Android](https://osmand.net/docs/"
"versions/free-versions)."
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/content-packs/apps/f-droid-repo.mdx:1
#, no-wrap
msgid "How to Create Your Own F-Droid Repo to Share as a Content Pack"
msgstr ""
#. type: Title #
#: docs/content-packs/apps/f-droid-repo.mdx:6
#, no-wrap
msgid "F-Droid Repo"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:9
msgid ""
"You can build your own curated F-Droid repo using your computer's terminal. "
"Once set up, users can connect their F-Droid app to your Butter Box and "
"start downloading apps."
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:12
#, no-wrap
msgid "Step 1: Install F-Droid Server Tools"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:15
msgid ""
"Before you begin, you need to install a tool called **fdroidserver**. This "
"helps you create and manage your app store."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:17
#, no-wrap
msgid "**On Mac (using Homebrew):**\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:18
#, no-wrap
msgid " brew install fdroidserver \n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:23
#, no-wrap
msgid "**On Linux (Debian/Ubuntu):**\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:24
#, no-wrap
msgid " sudo apt install fdroidserver \n"
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:28
#, no-wrap
msgid "Step 2: Check that it's installed correctly"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:31
msgid "After installation, run this command:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:32
#, no-wrap
msgid " fdroid version\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:37
msgid ""
"If everything is working, you will see a version number printed on the "
"screen."
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:38
#, no-wrap
msgid "Step 3: Create Your Repo Folder"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:41
msgid ""
"You need to create the folder where you will save the repo files in your "
"computer, choose a name that aligns with the project or purpose of the apps "
"in it, and replace my-fdroid-repo for that name in the command."
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:42
#, no-wrap
msgid "mkdir -p ~/my-fdroid-repo\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:46
#, no-wrap
msgid "cd ~/my-fdroid-repo\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:50
#, no-wrap
msgid "Step 4: Initialize the repo"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:52
#, no-wrap
msgid "fdroid init\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:57
msgid "This creates the following directories in your repo file:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:58
#, no-wrap
msgid "Config.yml \n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:62
#, no-wrap
msgid "repo/\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:66
#, no-wrap
msgid "metadata/\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:70
#, no-wrap
msgid "Step 5: Add your APKs"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:73
msgid ""
"Copy your signed APKs into the repo/ folder. Ensure you only use apps from "
"trusted sources like the official F-Droid library or verified developers."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:75
#, no-wrap
msgid "**Security Note:** Avoid downloading APKs from \"mirror\" sites or unknown sources, as they can contain malware or trackers that compromise your users' privacy.\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:76
#, no-wrap
msgid "cp /path/to/your/*.apk repo/\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:81
msgid "Example:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:82
#, no-wrap
msgid "cp ~/Downloads/myapp.apk repo/\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:86
#, no-wrap
msgid "Step 6: Generate (and Update) the Repository Index"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:89
msgid ""
"Every time you add a new APK or a new version of an app to your repo/ "
"folder, you must run the following command to \"publish\" those changes:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:90
#, no-wrap
msgid "fdroid update --create-metadata\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:95
msgid "What this command does:"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:100
msgid "**Scans APKs:** It reads the new files in your repo/ folder."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:100
msgid ""
"**Generates Metadata:** It creates YAML files containing the app's name, "
"version, and permissions."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:100
msgid ""
"**Creates index.v1.jar:** This is the \"catalog\" file that the F-Droid app "
"downloads to see what is available."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:100
msgid ""
"**Signs the Repository:** It uses your secret key to sign the index, proving "
"to the Android app that the files haven't been tampered with."
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:101
#, no-wrap
msgid "Step 7: Test your Repo locally"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:104
msgid ""
"To test your repo locally and ensure everything works before you share it on "
"the Butter Box, you can serve its content locally and add it to F-Droid "
"using a URL."
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:105
#, no-wrap
msgid "cd repo\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:109
#, no-wrap
msgid "python3 -m http.server 8000\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:114
#, no-wrap
msgid "Once your repo is live, open the F-Droid app on your device and navigate to **Settings > Repositories > \"+\"**. Select **\"Enter repository URL manually\"** to add your new source.\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:116
msgid ""
"Adding the repo manually allows you to verify the user experience by "
"checking:"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
msgid "**App Visibility:** Are all your apps appearing in the list?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
msgid "**Visual Assets:** Are icons and screenshots displaying correctly?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
msgid ""
"**Categorization:** Are apps appearing in the correct sections (e.g., "
"Internet, Security)?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
msgid ""
"**Functionality:** Do the downloads and installations complete without "
"errors?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
msgid ""
"**Metadata:** Does the version number and description match your `repo/` "
"files?"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:126
msgid "Your repo will be available at:"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:128
msgid "`http://YOUR-IP:8000/repo`"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:132
#, no-wrap
msgid "**Find your IP:**\n"
msgstr ""
#. type: Title ####
#: docs/content-packs/apps/f-droid-repo.mdx:133
#, no-wrap
msgid "macOS:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:135
#, no-wrap
msgid "ipconfig getifaddr en0\n"
msgstr ""
#. type: Title ####
#: docs/content-packs/apps/f-droid-repo.mdx:139
#, no-wrap
msgid "Linux:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:141
#, no-wrap
msgid "hostname -I\n"
msgstr ""
#. type: Title #
#: docs/content-packs/apps/index.mdx:4
#, no-wrap
msgid "Apps"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:7
msgid ""
"You can share apps as a content pack, via a static website. If you give a "
"folder the name `appstore` and place it in the root directory of the USB "
"drive, the **Apps** tile will appear in the Butter Box portal."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:9
#, no-wrap
msgid "**Things To Know**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:14
msgid ""
"If you are sharing apps from Butter Box, you will need to download the app "
"files you want to share. Apps are updated frequently. Be sure to manually "
"update all of the app files frequently to ensure you are providing the "
"highest security for the people who connect to the box."
msgstr ""
#. type: Bullet: ' * '
#: docs/content-packs/apps/index.mdx:14
msgid ""
"Youll need a copy of the apps `.apk` file make sure its from a safe and "
"trusted source."
msgstr ""
#. type: Bullet: ' * '
#: docs/content-packs/apps/index.mdx:14
msgid ""
"Butter wont automatically verify the source, so it's up to you to confirm "
"it's clean and legal to share."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:14
msgid ""
"How to get apk files: There are mobile apps you can use to get access to apk "
"files on an Android phone. Alternatively, you can download app files "
"directly from the developer's website."
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/index.mdx:15
#, no-wrap
msgid "Go Further: Butter Box Supports Sharing Via F-Droid"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:18
msgid ""
"Additionally, Butter Box supports app distribution via F-Droid. In your "
"content pack, you can include the F-Droid `.apk` and a QR code for your "
"repo. Anyone with access to the Box can then download the F-Droid app while "
"offline, and add the repo."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:20
msgid ""
"As long as they are connected to the Butter Box, they can download any of "
"the apps within your repo."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:22
msgid ""
"If they are connected to the internet later, they can receive app updates "
"from any apps in your repo that are also included in the official F-Droid "
"repo. If you update the apps in your repo, they will also have access to "
"those."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:24
msgid "What is a F-Ddroid Repo?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:29
msgid "A hosted library of apps\\ Why use it?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:29
msgid ""
"It offers a secure process for sharing apps. The F-Droid team builds apps in "
"the official F-Droid repo from the source code themselves. This ensures that "
"the app you download exactly matches the code the developer published."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:29
msgid ""
"Users installing from F-Droid have access to app updates remotely (away from "
"the Butter Box)"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:30
msgid ""
"Technical skills are required to create your own F-Droid repo. Refer to the "
"[F-Droid Repo](f-droid-repo) Section for instructions."
msgstr ""
#. type: Title #
#: docs/faq/how-to-reformat-your-usb-drive.mdx:4
#, no-wrap
msgid "How to Reformat Your USB Drive"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:7
msgid ""
"After connecting your USB drive to the Raspberry Pi you will see the Explore "
"USB title displayed on the portal. If youve tried refreshing your portal "
"page and still do not see the Explore USB tile then you may need to erase "
"your USB stick and reformat it."
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:9
#, no-wrap
msgid "<br/>\n"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:13
#, no-wrap
msgid "When you format a USB drive, all files and folders on the drive are removed and replaced with a new file system. This can help repair any issues with the flash drive itself or make it compatible with new files you want to transfer. Be sure to back up your files before formatting your drive. <br/>\n"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:15
#, no-wrap
msgid "**Check the Format of the USB**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:20
msgid "On your desktop or laptop, plug in your USB"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:20
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid "Right, or double-click on the USB"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:20
msgid "Click on Get info and verify the Format"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:20
msgid "Your USB needs to be formatted to ExFat or Fat32, MS-DOS (FAT)."
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:24
#, no-wrap
msgid "**Reformatting Steps on MacOS:**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
msgid "Connect the USB drive to a USB port on your computer."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid "Click on Erase Disk"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid "You can rename your USB at this time"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid "Select the correct format, either ExFat or ExFat32 or MS-DOS (FAT)"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid "Then tap Erase"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid ""
"A message may appear warning you that all content will be deleted. Select "
"Erase"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid ""
"This may take a few minutes. The USB will disappear and reappear on your "
"homescreen"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid "Verify the drive is correctly formatted"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
msgid "Click on Get info and verify the Format<br/>"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:38
#, no-wrap
msgid "**Reformatting Steps on Windows:**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
msgid "Open the File Explorer and select \"This PC\" from the menu."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
msgid ""
"You can find this option in the left panel, next to a monitor icon.[\\[2\\]]"
"You can use your Butter Box to share media, files, and digital books. To "
"display additional content in your portal, connect a USB drive containing "
"the information you want to share."
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:13
msgid ""
"If youd like more control over how your content is displayed, you can build "
"a **static website** and share it through the Butter Box. Learn more in the "
"[Content Packs](../content-packs/) section."
msgstr ""
#. type: Title ###
#: docs/services/file-sharing.mdx:16
#, no-wrap
msgid "Add files to your USB Drive"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:19
msgid ""
"Place individual files directly in the **main directory** (root) of your USB "
"drive. Or, create folders to organize your files (eg. \"Books\", \"Music\", "
"\"Reports)"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:21
#, no-wrap
msgid "<figure><img src=\"/img/docs/Screenshot 2025-08-16 at 9.50.15 PM.png\" alt=\"\"/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>\n"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:23
#, no-wrap
msgid "**Things to Know**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/services/file-sharing.mdx:26
msgid ""
"The **folder names you use** on your USB drive will be shown in the Butter "
"Box portal."
msgstr ""
#. type: Bullet: '* '
#: docs/services/file-sharing.mdx:26
msgid ""
"Organizing content into folders makes it easier for others to browse and "
"download."
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:30
msgid ""
"Insert the USB drive into your Butter Box. After connecting your USB drive "
"to the Raspberry Pi you will see the **Files** tile displayed when you open "
