From d2403b02cca352c495c058284e5e60985937cdae Mon Sep 17 00:00:00 2001 From: irl Date: Wed, 29 Apr 2026 16:24:33 +0200 Subject: [PATCH] Added translation using Weblate (Tibetan) --- po4a/bo.po | 3625 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 3625 insertions(+) create mode 100644 po4a/bo.po diff --git a/po4a/bo.po b/po4a/bo.po new file mode 100644 index 0000000..0fee037 --- /dev/null +++ b/po4a/bo.po @@ -0,0 +1,3625 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR , YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2026-04-24 16:24+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"Language: bo\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#. type: Yaml Front Matter Hash Value: description +#: docs/index.mdx:1 +#, no-wrap +msgid "Sharing offline has never been easier!" +msgstr "" + +#. type: Yaml Front Matter Hash Value: sidebar_position +#: docs/index.mdx:1 docs/build-a-box/raspberry-pi/index.mdx:1 +#: docs/content-packs/index.mdx:1 docs/content-packs/apps/index.mdx:1 +#: docs/faq/index.mdx:1 docs/services/index.mdx:1 +#, no-wrap +msgid "1" +msgstr "" + +#. type: Title ### +#: docs/index.mdx:6 docs/content-packs/index.mdx:29 +#, markdown-text, no-wrap +msgid "Get Started" +msgstr "" + +#. type: Plain text +#: docs/index.mdx:9 +#, markdown-text +msgid "" +"Butter Box is a lightweight, portable device that functions like a hard " +"drive with its own hotspot. Anyone nearby can connect to it and view or " +"download its contents—no internet required." +msgstr "" + +#. type: Plain text +#: docs/index.mdx:11 +#, markdown-text +msgid "" +"Whether you have a Butter Box in your hands or you need to build one, you're " +"in the right spot. Choose an option below." +msgstr "" + +#. type: Title ## +#: docs/index.mdx:12 +#, markdown-text, no-wrap +msgid "[I Have A Box](quick-start.mdx) ...or... [I Need A Box](build-a-box/)" +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/security.mdx:1 +#, no-wrap +msgid "How to Make a Butter Box Tamper Resistant" +msgstr "" + +#. type: Yaml Front Matter Hash Value: sidebar_position +#: docs/security.mdx:1 +#, no-wrap +msgid "7" +msgstr "" + +#. type: Title # +#: docs/security.mdx:6 +#, markdown-text, no-wrap +msgid "Security" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:9 +#, markdown-text +msgid "" +"This guide was designed for deployments in hostile, semi-hostile, or " +"low-trust environments, where devices may be inspected, confiscated, " +"modified, or misused. It aims to provide practical recommendations to make " +"the Butter Box more physically and digitally tamper-resistant." +msgstr "" + +#. type: Plain text +#: docs/security.mdx:11 +#, markdown-text +msgid "" +"Following the recommendations in this guide will help reduce risk, not " +"guarantee absolute security. Butter Box is assumed to be a field-deployable, " +"low-cost, offline system, so these recommendations prioritize realistic, " +"maintainable protections." +msgstr "" + +#. type: Plain text +#: docs/security.mdx:13 +#, markdown-text, no-wrap +msgid "**Threat Model Assumptions**\n" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:15 +#, markdown-text +msgid "" +"Before applying controls, clearly define your deployment context. This guide " +"assumes one or more of the following risks:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:22 +#, markdown-text +msgid "Physical access by unauthorized users" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:22 +#, markdown-text +msgid "Device confiscation or inspection by authorities" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:22 +#, markdown-text +msgid "Curious or malicious local users" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:22 +#, markdown-text +msgid "Content manipulation or replacement" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:22 +#, markdown-text +msgid "Network misuse or impersonation" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:22 +#, markdown-text +msgid "Credential reuse or default configuration abuse" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:24 +#, markdown-text +msgid "" +"Remember that controls should adapt to the local risk level, over-hardening " +"can reduce usability and trust." +msgstr "" + +#. type: Title ### +#: docs/security.mdx:27 +#, markdown-text, no-wrap +msgid "Section 1: Physical Tamper Resistance" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:29 +#, markdown-text, no-wrap +msgid "Enclosure and Hardware Protection" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:32 +#, markdown-text +msgid "" +"Physical access to the Butter Box allows SD card cloning, firmware " +"replacement, malware injection and broadcasting of malicious " +"information. PCB are also delicate and should have additional protection to " +"keep them safe from everyday handling and weather exposure." +msgstr "" + +#. type: Plain text +#: docs/security.mdx:34 docs/security.mdx:48 docs/security.mdx:70 +#: docs/security.mdx:83 docs/security.mdx:121 docs/security.mdx:130 +#, markdown-text +msgid "Recommendations:" +msgstr "" + +#. type: Bullet: '1. ' +#: docs/security.mdx:38 +#, markdown-text +msgid "Use a sealed or semi-sealed enclosure (screws instead of snap-fit)" +msgstr "" + +#. type: Bullet: '2. ' +#: docs/security.mdx:38 +#, markdown-text +msgid "Prefer tamper-evident screws (Torx, security hex)" +msgstr "" + +#. type: Bullet: '3. ' +#: docs/security.mdx:38 +#, markdown-text +msgid "Apply tamper-evident stickers over enclosure seams and SD card slots" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:42 +#, markdown-text, no-wrap +msgid "" +"| 1) Sealed enclosures | 2) Screws " +"|\n" +"| --------------------------------- | " +"--------------------------------------- |\n" +"| ![](/img/docs/unknown.jpeg) | ![]() |\n" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:43 +#, markdown-text, no-wrap +msgid "![]()" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:45 +#, markdown-text, no-wrap +msgid "SD Card & Storage Protection" +msgstr "" + +#. type: Bullet: '1. ' +#: docs/security.mdx:53 +#, markdown-text +msgid "Use high-quality SD cards to reduce corruption" +msgstr "" + +#. type: Bullet: '2. ' +#: docs/security.mdx:53 +#, markdown-text +msgid "Encrypt sensitive partitions (where feasible)" +msgstr "" + +#. type: Bullet: '3. ' +#: docs/security.mdx:53 +#, markdown-text +msgid "Keep content and OS separated (firmware vs content packs)" +msgstr "" + +#. type: Bullet: '4. ' +#: docs/security.mdx:53 +#, markdown-text +msgid "Avoid labeling SD cards with sensitive identifiers" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:55 +#, markdown-text +msgid "Optional (higher risk contexts):" +msgstr "" + +#. type: Bullet: '1. ' +#: docs/security.mdx:58 +#, markdown-text +msgid "" +"Epoxy Resin. Electronico potting solutions ​​protect Printed Circuit Boards " +"from extreme temperatures, moisture, vibration, and other environmental " +"threats." +msgstr "" + +#. type: Bullet: '2. ' +#: docs/security.mdx:58 +#, markdown-text +msgid "Physically block SD card removal" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:64 +#, markdown-text, no-wrap +msgid "" +"| Epoxy Resin | Epoxy Resin " +"|\n" +"| --------------------------------------- | " +"--------------------------------------- |\n" +"| ![]() | ![]() |\n" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:65 +#, markdown-text, no-wrap +msgid "![]()" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:67 +#, markdown-text, no-wrap +msgid "Power & Port Management" +msgstr "" + +#. type: Bullet: '1. ' +#: docs/security.mdx:75 +#, markdown-text +msgid "" +"Disable or physically block unused ports (USB, HDMI). Inexpensive physical " +"port blockers can be used to reduce the risk of tampering with the Butter " +"Box by preventing unauthorized access to exposed interfaces. These blockers " +"limit the ability of bad actors to inject malicious code, connect " +"unauthorized peripherals, or broadcast unwanted content. Ports are sealed " +"with plastic blockers that can only be removed using a dedicated key " +"included in the deployment kit." +msgstr "" + +#. type: Bullet: '2. ' +#: docs/security.mdx:75 +#, markdown-text +msgid "" +"Avoid exposing Ethernet ports unless required. Ethernet ports should remain " +"disabled or physically blocked unless they are explicitly required for the " +"deployment. When Ethernet access is necessary, its use should be clearly " +"documented and limited to trusted operators." +msgstr "" + +#. type: Bullet: '3. ' +#: docs/security.mdx:75 +#, markdown-text +msgid "Use short internal cables to reduce easy probing" +msgstr "" + +#. type: Bullet: '4. ' +#: docs/security.mdx:75 +#, markdown-text +msgid "Label power banks generically (avoid project names)" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:79 +#, markdown-text, no-wrap +msgid "" +"| USB & HDMI | Ethernet Ports " +"|\n" +"| --------------------------------------- | " +"--------------------------------------- |\n" +"| ![]() | ![]() |\n" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:80 +#, markdown-text, no-wrap +msgid "Environmental & Operational Practices" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:88 +#, markdown-text +msgid "Store boxes in controlled locations when not in use" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:88 +#, markdown-text +msgid "Rotate devices periodically in long deployments" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:88 +#, markdown-text +msgid "Assume devices may be copied or lost" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:88 +#, markdown-text +msgid "" +"Treat Butter Boxes as semi-disposable infrastructure, not personal " +"devices.
" +msgstr "" + +#. type: Title ### +#: docs/security.mdx:89 +#, markdown-text, no-wrap +msgid "Section 2: Digital Tamper Resistance" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:91 +#, markdown-text, no-wrap +msgid "Credential Hygiene (Critical)" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:94 +#, markdown-text +msgid "Mandatory actions:" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:96 +#, markdown-text +msgid "SSH" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:100 +#, markdown-text +msgid "By default, the pi user has the password butterbox-admin." +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:100 +#, markdown-text +msgid "Change this password by sshing into the pi and running passwd." +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:100 +#, markdown-text +msgid "" +"If you'd prefer to use an SSH key, be sure to disable password access once " +"you enable key-based access." +msgstr "" + +#. type: Plain text +#: docs/security.mdx:102 +#, markdown-text +msgid "RaspAP" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:106 +#, markdown-text +msgid "" +"The access point has an administrative interface that can be used to change " +"its settings." +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:106 +#, markdown-text +msgid "Defaults: user: admin, password: secret (ironically, this is not secret)." +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:106 +#, markdown-text +msgid "" +"Change this by logging in at[ " +"http://butterbox.lan/admin](http://butterbox.lan/admin) (or[ " +"http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin) for " +"a Spanish language box) and using the Web UI." +msgstr "" + +#. type: Plain text +#: docs/security.mdx:108 +#, markdown-text +msgid "Chat" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:111 +#, markdown-text +msgid "" +"The local chat was created by an administrative user called " +"butterbox-admin. The password for this user is also butterbox-admin." +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:111 +#, markdown-text +msgid "" +"Change this password by logging into the Butter Box, going to the public " +"chatroom, then visiting your user profile and updating the password. At your " +"discretion, you may also wish to change the name from butterbox-admin so " +"that other users will recognize you." +msgstr "" + +#. type: Plain text +#: docs/security.mdx:113 +#, markdown-text +msgid "Best practices:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:117 +#, markdown-text +msgid "Use unique passwords per deployment" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:117 +#, markdown-text +msgid "Store credentials offline in secure documentation" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:117 +#, markdown-text +msgid "Never reuse credentials across regions" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:118 +#, markdown-text, no-wrap +msgid "Service Hardening" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:126 +#, markdown-text +msgid "Disable services not strictly required:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:126 +#, markdown-text +msgid "SSH (or restrict to key-based auth)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:126 +#, markdown-text +msgid "Bluetooth" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:126 +#, markdown-text +msgid "USB ports" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:127 +#, markdown-text, no-wrap +msgid "Content Integrity & Authenticity" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:134 +#, markdown-text +msgid "Keep firmware immutable during normal operation" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:134 +#, markdown-text +msgid "Maintain a known-good baseline image" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:134 +#, markdown-text +msgid "Re-flash devices periodically in long deployments" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:136 +#, markdown-text +msgid "Operational control:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:139 +#, markdown-text +msgid "Only trusted operators should install or update content" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:139 +#, markdown-text +msgid "Document update sources and dates" +msgstr "" + +#. type: Title ### +#: docs/security.mdx:142 +#, markdown-text, no-wrap +msgid "Section 3: Misuse & Abuse Mitigation" +msgstr "" + +#. type: Title #### +#: docs/security.mdx:144 +#, markdown-text, no-wrap +msgid "Local Chat & Content Abuse" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:147 +#, markdown-text +msgid "Risks:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:151 +#, markdown-text +msgid "Harassment or hate speech" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:151 +#, markdown-text +msgid "Impersonation" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:151 +#, markdown-text +msgid "Disinformation spread" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:153 +#, markdown-text +msgid "Mitigations:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:159 +#, markdown-text +msgid "Clear usage guidelines displayed locally" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:159 +#, markdown-text +msgid "Community moderation roles (if appropriate)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:159 +#, markdown-text +msgid "Ability to reset or wipe chat data quickly" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:159 +#, markdown-text +msgid "Limit who can upload or replace content" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:159 +#, markdown-text +msgid "Keep a read-only mode for most users" +msgstr "" + +#. type: Title ### +#: docs/security.mdx:162 +#, markdown-text, no-wrap +msgid "Section 4: Incident Response & Recovery" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:165 +#, markdown-text +msgid "Prepare for compromise:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:169 +#, markdown-text +msgid "Assume some devices will be tampered with" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:169 +#, markdown-text +msgid "Maintain a simple wipe and re-flash procedure" +msgstr "" + +#. type: Bullet: '* ' +#: docs/security.mdx:169 +#, markdown-text +msgid "Track deployments" +msgstr "" + +#. type: Plain text +#: docs/security.mdx:170 docs/faq/how-to-reformat-your-usb-drive.mdx:57 +#, markdown-text, no-wrap +msgid "
\n" +msgstr "" + +#. 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 +#, markdown-text, no-wrap +msgid "Use Cases" +msgstr "" + +#. type: Title ### +#: docs/case-studies.mdx:6 +#, markdown-text, no-wrap +msgid "1. Digital Security training to distribute apps and materials" +msgstr "" + +#. type: Plain text +#: docs/case-studies.mdx:11 +#, markdown-text, 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 +#, markdown-text, no-wrap +msgid "2. Sharing & Media Backup" +msgstr "" + +#. type: Plain text +#: docs/case-studies.mdx:15 +#, markdown-text, no-wrap +msgid "" +"> Often M. wants to share music and movie files that they’ve 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 Wi‑Fi " +"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 +#, markdown-text, no-wrap +msgid "3. Temporary file storage" +msgstr "" + +#. type: Plain text +#: docs/case-studies.mdx:18 +#, markdown-text, 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 Box’s 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 +#: docs/quick-start.mdx:1 docs/build-a-box/pc-laptop.mdx:1 +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:1 +#: docs/content-packs/maps.mdx:1 docs/content-packs/apps/f-droid-repo.mdx:1 +#: docs/faq/how-to-reformat-your-usb-drive.mdx:1 +#: docs/services/file-sharing.mdx:1 +#, no-wrap +msgid "2" +msgstr "" + +#. type: Title # +#: docs/quick-start.mdx:4 +#, markdown-text, no-wrap +msgid "Quick Start" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:7 +#, markdown-text +msgid "" +"If you have a Butter Box with the latest version of the Butter software " +"loaded on the SD card, take these quick steps to get set up." +msgstr "" + +#. type: Title ### +#: docs/quick-start.mdx:8 +#, markdown-text, no-wrap +msgid "Check supplies" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:11 +#, markdown-text +msgid "Make sure you have the supplies for a basic box:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/quick-start.mdx:17 +#, markdown-text +msgid "[ ] Power source" +msgstr "" + +#. type: Bullet: '* ' +#: docs/quick-start.mdx:17 +#, markdown-text +msgid "[ ] USB drive" +msgstr "" + +#. type: Bullet: '* ' +#: docs/quick-start.mdx:17 +#, markdown-text +msgid "[ ] USB Adapters (as needed)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/quick-start.mdx:17 +#, markdown-text +msgid "[ ] Butter Box Device (with micro SD card inserted)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/quick-start.mdx:17 +#, markdown-text +msgid "[ ] Case" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:19 +#, markdown-text, no-wrap +msgid "" +"
\n" +msgstr "" + +#. type: Title ### +#: docs/quick-start.mdx:20 +#, markdown-text, no-wrap +msgid "Make sure the micro SD card is inserted into the device" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:23 +#, markdown-text +msgid "The micro SD card should have the latest version of Butter OS running on it." +msgstr "" + +#. type: Title ### +#: docs/quick-start.mdx:24 +#, markdown-text, no-wrap +msgid "Plug it in to power on" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:27 +#, markdown-text +msgid "" +"Connect the power supply to the first micro USB port and correct wall " +"outlet." +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:29 +#, markdown-text, no-wrap +msgid "" +"
\"\"
\n" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:31 +#, markdown-text +msgid "" +"You will know the box is working if ‘butterbox’ wifi appears in the wifi " +"list on your phone or computer. If it doesn’t, unplug the box and plug it " +"back in." +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:35 +#, markdown-text +msgid "" +"_If using a solar battery or other means of power, use one with the correct " +"specs to ensure adequate power and avoid damage to the unit. For a Pi Zero 2 " +"W use Micro USB power supply with at least 2.0A._" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:37 +#, markdown-text +msgid "[Link to Power Supply Options](build-a-box/power-supply)" +msgstr "" + +#. type: Title ### +#: docs/quick-start.mdx:40 +#, markdown-text, no-wrap +msgid "Insert USB drive" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:43 +#, markdown-text +msgid "" +"Connect the USB adapter to the open port. Then plug in the USB drive. Learn " +"more about loading the USB drive with treasures in the [File " +"Sharing](services/file-sharing) section." +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:45 +#, markdown-text, no-wrap +msgid "" +"
\"\"
\n" +msgstr "" + +#. type: Title ### +#: docs/quick-start.mdx:46 +#, markdown-text, no-wrap +msgid "Access the Butter Box Portal" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:49 +#, markdown-text +msgid "" +"Join the ‘butterbox’ Wi-Fi. After 30 seconds, scan the QR code on the " +"box. This connects you to **http://butterbox.local** in a browser." +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:51 +#, markdown-text +msgid "[https://youtu.be/KB5O9MSoaAg](https://youtu.be/KB5O9MSoaAg)" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:53 +#, markdown-text, no-wrap +msgid "" +"
\"\"
\n" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:55 +#, markdown-text +msgid "" +"_If this page does not load, wait a few minutes to ensure " +"connectivity. Refresh the page. If you’re 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 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Once connected, use Admin Settings to set up your box." +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:65 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Share access to the portal" +msgstr "" + +#. type: Plain text +#: docs/quick-start.mdx:69 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Update Butter" +msgstr "" + +#. type: Title ### +#: docs/update-butter.mdx:6 +#, markdown-text, no-wrap +msgid "Check out new releases from the Butter Box team" +msgstr "" + +#. type: Plain text +#: docs/update-butter.mdx:9 docs/build-a-box/raspberry-pi/install-butter.mdx:19 +#, markdown-text +msgid "[https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0](https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0)" +msgstr "" + +#. type: Fenced div block (info) +#: docs/update-butter.mdx:10 +#, no-wrap +msgid "Always choose the Latest Version of the file\n" +msgstr "" + +#. type: Title ### +#: docs/update-butter.mdx:14 +#, markdown-text, no-wrap +msgid "Early Access Development Releases" +msgstr "" + +#. type: Plain text +#: docs/update-butter.mdx:17 +#, markdown-text +msgid "" +"WARNING: These are early releases posted for development testing and MUST " +"NOT be used in production deployments." +msgstr "" + +#. type: Plain text +#: docs/update-butter.mdx:19 +#, markdown-text +msgid "" +"[Download Early Access Development " +"Images](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list)" +msgstr "" + +#. type: Title ### +#: docs/update-butter.mdx:20 +#, markdown-text, no-wrap +msgid "Update your Butter Box" +msgstr "" + +#. type: Plain text +#: docs/update-butter.mdx:22 +#, markdown-text +msgid "" +"Update your Butter Box using the same guide with the steps you take when you " +"are setting a Butter Box up for the first time. You can find it here: " +"[Raspberry Pi Install](build-a-box/raspberry-pi/install-butter)" +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/build-a-box/index.mdx:1 +#, no-wrap +msgid "DIY instructions" +msgstr "" + +#. type: Title # +#: docs/build-a-box/index.mdx:5 +#, markdown-text, no-wrap +msgid "Build A Box" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/index.mdx:8 +#, markdown-text +msgid "" +"Don’t have a Butter Box yet? You can easily build your own. Choose your " +"setup to get started." +msgstr "" + +#. type: Title ## +#: docs/build-a-box/index.mdx:9 +#, markdown-text, no-wrap +msgid "Butter Box Setups" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/index.mdx:12 +#, markdown-text +msgid "" +"Butter Box software currently runs on Raspberry Pi devices: Pi Zero 2 and Pi " +"4. You can use either one. See comparison chart below for details." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/index.mdx:18 +#, markdown-text, no-wrap +msgid "" +"| Device " +"| Capacity | " +"Supplies |\n" +"| " +"-------------------------------------------------------------------------------------------------------------------------------- " +"| ----------------------------------------------------------------- | " +"------------------------------------------------- |\n" +"|

Basic

Raspberry Pi Zero Pi 2

Get Started

| Up to 10 " +"people, About 10 meters apart | [Supply " +"List](raspberry-pi/basic-box-supplies) |\n" +"|

Extended

Raspberry Pi 4 + Router

Get Started

| Up to 20 people, " +"About 30 meters apart when paired with a router | [Supply " +"List](raspberry-pi/extend-your-box) |\n" +"| PC/Laptop (amd64) " +"| _Coming soon_ | " +"_Coming soon_ |\n" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/index.mdx:20 +#, markdown-text +msgid "" +"We also make and ship Butter Boxes to partners worldwide. If you serve a " +"community that could benefit, we’d love to hear from you." +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/build-a-box/pc-laptop.mdx:1 +#, no-wrap +msgid "How to turn an old PC into golden deliciuos butter!" +msgstr "" + +#. type: Title # +#: docs/build-a-box/pc-laptop.mdx:6 +#, markdown-text, no-wrap +msgid "PC/Laptop Support (BETA!)" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/pc-laptop.mdx:9 +#, markdown-text +msgid "" +"An important new development for the ButterBox project is the ability to " +"turn any Intel or AMD 64-bit PC into a ButterBox. In many places in the " +"world, getting access to an official RaspberryPi is difficult and " +"expensive. However, no matter where you are in the world, there seem to be " +"plenty of \"old\", unloved, discarded PC towers and laptops." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/pc-laptop.mdx:11 +#, markdown-text +msgid "" +"This page will help you bring new life to that old tech, by turning it into " +"the best kind of buttery local microserver, that even has a built-in " +"battery, screen and keyboard!" +msgstr "" + +#. type: Title ## +#: docs/build-a-box/pc-laptop.mdx:12 +#, markdown-text, no-wrap +msgid "Download the Image" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/pc-laptop.mdx:15 +#, markdown-text +msgid "" +"Access to new images of ButterBox built for Intel/AMD64 devices are now " +"available IN EARLY BETA through our [development image distribution " +"site](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list). " +"Download the latest image that beings with \"amd64_butter_main_\"." +msgstr "" + +#. type: Title ## +#: docs/build-a-box/pc-laptop.mdx:16 +#, markdown-text, no-wrap +msgid "How to Flash" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/pc-laptop.mdx:19 +#, markdown-text +msgid "" +"This image can be flashed to a bootable USB drives, using " +"[balenaEtcher](https://etcher.balena.io/)." +msgstr "" + +#. type: Bullet: '1. ' +#: docs/build-a-box/pc-laptop.mdx:26 +#, markdown-text +msgid "Install balenaEtcher" +msgstr "" + +#. type: Bullet: '2. ' +#: docs/build-a-box/pc-laptop.mdx:26 +#, markdown-text +msgid "" +"Download the AMD64 image and unpack it (remove .tar and .gz with \"unzip\" " +"tool)" +msgstr "" + +#. type: Bullet: '3. ' +#: docs/build-a-box/pc-laptop.mdx:26 +#, markdown-text +msgid "Select the image file in balenaEtcher" +msgstr "" + +#. type: Bullet: '4. ' +#: docs/build-a-box/pc-laptop.mdx:26 +#, markdown-text +msgid "Plugin the USB flash drive" +msgstr "" + +#. type: Bullet: '5. ' +#: docs/build-a-box/pc-laptop.mdx:26 +#, markdown-text +msgid "Select the drive in balenaEtcher" +msgstr "" + +#. type: Bullet: '6. ' +#: docs/build-a-box/pc-laptop.mdx:26 +#, markdown-text +msgid "Flash!" +msgstr "" + +#. type: Title ## +#: docs/build-a-box/pc-laptop.mdx:27 +#, markdown-text, no-wrap +msgid "How to Boot Up" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/pc-laptop.mdx:30 +#, markdown-text +msgid "" +"Once the USB drive is flashed, you can now use it to boot up ButterBox on " +"your old PC." +msgstr "" + +#. type: Bullet: '1. ' +#: docs/build-a-box/pc-laptop.mdx:36 +#, markdown-text +msgid "" +"Boot your old PC into the \"BIOS\" screen. Make sure it is configured to " +"allow for booting from the USB drive, before it boots the internal hard " +"drive." +msgstr "" + +#. type: Bullet: '2. ' +#: docs/build-a-box/pc-laptop.mdx:36 +#, markdown-text +msgid "Shutdown the PC." +msgstr "" + +#. type: Bullet: '3. ' +#: docs/build-a-box/pc-laptop.mdx:36 +#, markdown-text +msgid "Plug in the USB drive to the PC" +msgstr "" + +#. type: Bullet: '4. ' +#: docs/build-a-box/pc-laptop.mdx:36 +#, markdown-text +msgid "Start the PC, and make sure it boots from the USB drive." +msgstr "" + +#. type: Bullet: '5. ' +#: docs/build-a-box/pc-laptop.mdx:36 +#, markdown-text +msgid "Wait for the login terminal to appear!" +msgstr "" + +#. type: Title ## +#: docs/build-a-box/pc-laptop.mdx:37 +#, markdown-text, no-wrap +msgid "How to Access" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/pc-laptop.mdx:40 +#, markdown-text +msgid "" +"Once the ButterBox PC is booted up, and plugged into a local router, it " +"should be ready to access!" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/pc-laptop.mdx:42 +#, markdown-text +msgid "" +"Connect your personal device to the same network, and try to access " +"[http://butterbox.local](http://butterbox.local)" +msgstr "" + +#. type: Title ## +#: docs/build-a-box/pc-laptop.mdx:43 +#, markdown-text, no-wrap +msgid "Differences from RaspberryPi edition" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/pc-laptop.mdx:46 +#, markdown-text +msgid "" +"There are some important differences between ButterBox on PC versus on " +"RaspberryPi" +msgstr "" + +#. type: Bullet: '- ' +#: docs/build-a-box/pc-laptop.mdx:49 +#, markdown-text +msgid "" +"There is no built-in wifi hotspot. You must plug it into a dedicated wifi " +"router or network." +msgstr "" + +#. type: Bullet: '- ' +#: docs/build-a-box/pc-laptop.mdx:49 +#, markdown-text +msgid "" +"You can easily access the terminal \"root\" user to update and configured " +"(with great power, comes great responsibility!)" +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/build-a-box/power-supply.mdx:1 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:1 +#, no-wrap +msgid "Different ways to power your Butter Box" +msgstr "" + +#. type: Yaml Front Matter Hash Value: sidebar_position +#: docs/build-a-box/power-supply.mdx:1 +#: docs/build-a-box/raspberry-pi/install-butter.mdx:1 +#: docs/services/local-chat.mdx:1 +#, no-wrap +msgid "3" +msgstr "" + +#. type: Title # +#: docs/build-a-box/power-supply.mdx:6 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:5 +#, markdown-text, no-wrap +msgid "Power Supply" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/power-supply.mdx:9 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:8 +#, markdown-text +msgid "" +"If you want Butter to work completely off-grid and without electricity, it " +"can! Butter Boxes can be powered by a wall outlet, pre-charged battery pack " +"or solar powered battery pack." +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/power-supply.mdx:15 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:14 +#, markdown-text +msgid "" +"**Wall Outlet:** The official and recommended power supply for Raspberry Pi " +"computers (depends of the Raspberry Pi model that you are using)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/power-supply.mdx:15 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:14 +#, markdown-text +msgid "" +"**Pre-charged Battery Pack (Power Bank):** This is the most common option " +"for field use." +msgstr "" + +#. type: Bullet: ' * ' +#: docs/build-a-box/power-supply.mdx:15 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:14 +#, markdown-text +msgid "" +"Anker portable charger [power " +"bank](https://www.amazon.com/Anker-Portable-PowerCore-High-Speed-Charging/dp/B09VXF29RM/ref=sr_1_6?crid=30EJM6E540GE6\\&dib=eyJ2IjoiMSJ9.cMM86su3KXjp8lN7z7mvmL1HERSowjwoegVu1E_8xhH-Pl38rDD2hEv21fVqk-w2eogpdZGsfiLn_V8ij-PvaRw3RDBdv9-NTKTFqGOUj6IZJKMdbeUjGkgBFVFdZvyOkBFF6kau0uJIE-rRQyseWiNNPxZwan-29xuz2_f643gTOfOzERBuVK2cDdpm91rPdVsRl3dKy6iR1K7qkYW5YGTtYpaZWriYGWOovD2CcVA.SogXwrCYRlPyAkf0wzwye8_-ZdVw-Fi0EcM5vcr7ESk\\&dib_tag=se\\&keywords=anker%2Bpower%2Bbank%2Bbattery%2Bpack%2Bwhite\\&qid=1756265405\\&sprefix=anker%2Bpower%2Bbank%2Bbattery%2Bpack%2Bwhit%2Caps%2C154\\&sr=8-6\\&th=1)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/power-supply.mdx:15 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:14 +#, markdown-text +msgid "" +"**Solar Panel (with Power Bank):** Use a small solar panel to recharge your " +"power bank. This is a good option to keep the box running continuously in " +"off-grid locations. Using direct solar panel without a battery is possible, " +"but unstable if the sun dips in/out." +msgstr "" + +#. type: Bullet: ' * ' +#: docs/build-a-box/power-supply.mdx:15 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:14 +#, markdown-text +msgid "" +"Solar panel kits: " +"[https://voltaicsystems.com/solar-panel-kits/](https://voltaicsystems.com/solar-panel-kits/)" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/power-supply.mdx:16 +#: docs/build-a-box/raspberry-pi/power-supply.mdx:15 +#, markdown-text, no-wrap +msgid "" +"
\n" +msgstr "" + +#. type: Title # +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:4 +#, markdown-text, no-wrap +msgid "Basic Box Supplies" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:7 +#, markdown-text +msgid "" +"A basic Butter Box setup is a Raspberry Pi Zero 2 W with a microSD card " +"running the Butter software, a USB stick, powered by a USB source like a " +"power cord, power bank or solar panel." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:9 +#, markdown-text +msgid "" +"In most setups like this, a Butter Box can comfortably handle **4–10 " +"connected devices at once** without slowing down. It’s possible to have " +"more, but performance may drop if everyone is downloading large files or " +"videos at the same time." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:11 +#, markdown-text +msgid "" +"The reach for it is about **5–10 meters** indoors, depending on the " +"Raspberry Pi model and depending on walls and interference. Outdoors, in " +"open space, it can sometimes reach farther. Think of it like the range of a " +"home Wi-Fi router — enough to cover a classroom, a coffee shop, meeting " +"space, or small outdoor gathering." +msgstr "" + +#. type: Title ## +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:12 +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:12 +#, markdown-text, no-wrap +msgid "Supplies" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20 +#, markdown-text +msgid "" +"[ ] Raspberry Pi Zero 2W (64 Bit) " +"[https://www.adafruit.com/product/5291](https://www.adafruit.com/product/5291); " +"Or you can buy a kit here: [\\ " +"https://www.canakit.com/raspberry-pi-zero-2-w.html](https://www.canakit.com/raspberry-pi-zero-2-w.html)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20 +#, markdown-text +msgid "" +"[ ] Power outlet and power cord that accompanies the Raspberry Pi Zero 2W or " +"an [alternative power supply](../power-supply)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20 +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20 +#, markdown-text +msgid "" +"[ ] Micro SD Card: Images with the Butter software are usually under 16 GB " +"(we suggest 256 GB). Media that people upload to the chat ends up on the " +"card; it never gets cleared." +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20 +#, markdown-text +msgid "[ ] USB drive (min 32 GB)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20 +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20 +#, markdown-text +msgid "[ ] Adapters (as needed)" +msgstr "" + +#. type: Bullet: ' * ' +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:23 +#, markdown-text +msgid "[ ] Micro USB/Male to USB A/Female" +msgstr "" + +#. type: Bullet: ' * ' +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:23 +#, markdown-text +msgid "[ ] A dongle to connect the micro SD card to your laptop (if needed)" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:27 +#, markdown-text, no-wrap +msgid "**Once you have your supplies, continue in the Install Butter section.**\n" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:29 +#, markdown-text +msgid "[install-butter.md](install-butter)" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:31 +#, markdown-text, no-wrap +msgid "" +"
\n" +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:1 +#, no-wrap +msgid "How To Add a Router To Your Box Setup" +msgstr "" + +#. type: Yaml Front Matter Hash Value: sidebar_position +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:1 +#: docs/services/secure-messenger.mdx:1 +#, no-wrap +msgid "4" +msgstr "" + +#. type: Title # +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:6 +#, markdown-text, no-wrap +msgid "Extend Your Box" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:9 +#, markdown-text +msgid "" +"An extended Butter Box pairs the Raspberry Pi with a standalone Wi-Fi " +"router, giving stronger signal and more simultaneous connections." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:11 +#, markdown-text +msgid "" +"With the router, the network can reach 10-30 m (32-98 feet),and can " +"comfortably support 10–20 connected devices at the same time. This setup is " +"ideal for a medium group of people in a medium room, like classrooms, " +"events, or community spaces." +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20 +#, markdown-text +msgid "[ ] Raspberry Pi 4, 5 or Raspberry Pi Zero 2W" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20 +#, markdown-text +msgid "" +"[ ] Router ([Opal (GL-SFT1200) Wireless Travel " +"Router](https://store-us.gl-inet.com/products/united-states-opal-gl-sft1200-gigabit-wireless-router-dual-band-openwrt-ipv6-tor) " +"or equivilent)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20 +#, markdown-text +msgid "" +"[ ] Power outlet and power cords that accompany the Raspberry Pi and the " +"Router or an [alternative power supply](../power-supply)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20 +#, markdown-text +msgid "[ ] USB Drive (min 32 GB)" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:22 +#, markdown-text +msgid "_No internet connection is required._" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:24 +#, markdown-text, no-wrap +msgid "" +"
\n" +msgstr "" + +#. type: Title ## +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:27 +#, markdown-text, no-wrap +msgid "Steps" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:30 +#, markdown-text +msgid "" +"To extend your box, you simply connect a GLi-Net router to the Butter Box " +"with an ethernet cable. Instead of accessing the box from the portal Wi-Fi " +"hotspot (eg. 'butter box' or whichever name you set in the admin settings), " +"users will join the Wi-Fi network of the router." +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:31 +#, markdown-text, no-wrap +msgid "Connect the Butter Box to its power supply. " +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:34 +#, markdown-text +msgid "Connect the Butter Box to power." +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:35 +#, markdown-text, no-wrap +msgid "Connect Router" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:38 +#, markdown-text +msgid "" +"Connect the router to power. Then use the ethernet cable to connect to the " +"Butter Box. Make sure to plug the Ethernet cable into the LAN port on your " +"router." +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:39 +#, markdown-text, no-wrap +msgid "Test Your Connection" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:42 +#, markdown-text +msgid "" +"Join the router Wi-Fi. If you have not setup or used this router before, " +"enter the default password found in the user guide included in the " +"package. After 30 seconds, open http://butterbox.local in a browser." +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:43 +#, markdown-text, no-wrap +msgid "Disable Butter Box Wi-Fi Access Point" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:46 +#, markdown-text +msgid "" +"Open the admin settings from the Butter Box portal. Navigate to **Secure " +"Portal**. Turn off the Wi-Fi access point. This will hide the Wi-Fi network " +"that broadcasts from the raspberry pi, so that users don’t get confused " +"about which network to join." +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:47 +#, markdown-text, no-wrap +msgid "Invite Users to Join the Router Wi-Fi" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:49 +#, markdown-text +msgid "" +"Users will now join the Wi-Fi network of the router when they want to " +"connect to the Butter Box." +msgstr "" + +#. type: Title # +#: docs/build-a-box/raspberry-pi/index.mdx:4 +#, markdown-text, no-wrap +msgid "Raspberry Pi" +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/build-a-box/raspberry-pi/install-butter.mdx:1 +#, no-wrap +msgid "Install Butter Operating System (OS) on an SD card for Raspberry Pi" +msgstr "" + +#. type: Title # +#: docs/build-a-box/raspberry-pi/install-butter.mdx:6 +#, markdown-text, no-wrap +msgid "Install Butter" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:9 +#, markdown-text +msgid "You will need:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/install-butter.mdx:13 +#, markdown-text +msgid "Desktop computer" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/install-butter.mdx:13 +#, markdown-text +msgid "Internet Connection" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/install-butter.mdx:13 +#, markdown-text +msgid "Butter Box" +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:14 +#, markdown-text, no-wrap +msgid "Download the Butter OS for Raspberry Pi " +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:17 +#: docs/build-a-box/raspberry-pi/install-butter.mdx:85 +#, markdown-text +msgid "" +"Make sure the file size matches the size listed on the website. Sometimes " +"browsers do not complete the download, which can result in a corrupted file." +msgstr "" + +#. type: Fenced div block (info) +#: docs/build-a-box/raspberry-pi/install-butter.mdx:20 +#, no-wrap +msgid "Always choose the Latest Version of the file. \n" +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:24 +#, markdown-text, no-wrap +msgid "Plug the micro SD card into your computer" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:27 +#, markdown-text +msgid "" +"To plug the micro SD card into your computer, you may need an adapter to do " +"this:" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:29 +#, markdown-text, no-wrap +msgid "" +"
\"\"

Example adapter (USB-C to Micro " +"SD)

\n" +msgstr "" + +#. type: Fenced div block (info) +#: docs/build-a-box/raspberry-pi/install-butter.mdx:30 +#, no-wrap +msgid "You don't need to connect the box to the computer.\n" +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:34 +#, markdown-text, no-wrap +msgid "Run Raspberry Pi Imager " +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:37 +#, markdown-text +msgid "" +"Once you have your micro SD card plugged into your computer that has an " +"internet connection, run Raspberry Pi Imager from a desktop computer. It " +"will walk you through the steps to install the Butter operating system on " +"the micro SD card." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:39 +#, markdown-text +msgid "" +"If you don't have Raspberry Pi Imager, you can download it here: " +"[https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)" +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:40 +#, markdown-text, no-wrap +msgid "Choose device > **Raspberry Pi Zero 2 W**" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:43 +#, markdown-text +msgid "" +"Once the Raspberry Pi Image starts, you will be prompt to select your " +"Raspberry Pi device." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:45 +#, markdown-text, no-wrap +msgid "" +"

Select Raspberry Pi Zero 2 W (or the device you " +"have if it's not the standard box from Butter " +"HQ)

\n" +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:46 +#, markdown-text, no-wrap +msgid "Choose Operating System > Use Custom" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/install-butter.mdx:49 +#, markdown-text +msgid "" +"On the OS tab, select **Use custom** and upload the custom Butter OS .img " +"file. Confirm that you have **unzipped the file** before using it." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:51 +#, markdown-text, no-wrap +msgid "" +"

Select Use Custom. You will upload the custom .img " +"file that you downloaded from Dropbox.

\n" +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:52 +#, markdown-text, no-wrap +msgid "Choose Storage > Select Micro SD Card" +msgstr "" + +#. type: Bullet: '* ' +#: docs/build-a-box/raspberry-pi/install-butter.mdx:55 +#, markdown-text +msgid "From the **Storage** tab, select the **Micro SD Card.**" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:57 +#, markdown-text, no-wrap +msgid "" +"

Select the Micro SD " +"Card.

\n" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:59 +#, markdown-text +msgid "Your screen will look similar to this after all selections:" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:61 +#, markdown-text, no-wrap +msgid "" +"

Final screen after " +"selections.

\n" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:63 +#, markdown-text +msgid "" +"You may be prompt with _\"Doing this will erase all data from selected " +"external storage\"_ and “_do you want to apply settings”_, click then on " +"_“no clear settings”_." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:65 +#, markdown-text +msgid "" +"After that select _\"write\"_ and begin writing process to the Micro SD " +"card." +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:66 +#, markdown-text, no-wrap +msgid "" +"Remove From Computer and Insert Micro SD Card into the Raspberry Pi (Butter " +"Box)" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:69 +#, markdown-text +msgid "" +"Once you're done, remove the Micro SD card. Insert the Micro SD card into " +"the Raspberry Pi (Butter Box) not powered on." +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:70 +#, markdown-text, no-wrap +msgid "Go to Quick Start" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:73 +#, markdown-text +msgid "" +"Plug the Raspberry Pi (Butter Box) into power. Wait a few moments and " +"connect to the Butter Box Portal. Go to the [Quick Start](../../quick-start) " +"section for more details." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:75 +#, markdown-text, no-wrap +msgid "" +"**If you are building an extended box, continue in the next section: Extend " +"Your Box.**\n" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:77 +#, markdown-text +msgid "[extend-your-box.md](extend-your-box)" +msgstr "" + +#. type: Title ### +#: docs/build-a-box/raspberry-pi/install-butter.mdx:80 +#, markdown-text, no-wrap +msgid "Troubleshooting" +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:83 +#, markdown-text +msgid "" +"If you see an error stating that the input file is not a valid disk image, " +"check the file you downloaded." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:87 +#, markdown-text +msgid "Also confirm that you have **unzipped the file** before using it." +msgstr "" + +#. type: Plain text +#: docs/build-a-box/raspberry-pi/install-butter.mdx:88 +#, markdown-text, no-wrap +msgid "" +"
\n" +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/content-packs/index.mdx:1 +#, no-wrap +msgid "Curated pluggable content" +msgstr "" + +#. type: Title # +#: docs/content-packs/index.mdx:6 +#, markdown-text, no-wrap +msgid "Content Packs" +msgstr "" + +#. type: Plain text +#: docs/content-packs/index.mdx:9 +#, markdown-text +msgid "" +"You can create your own content pack! It simply needs to be set up as a " +"**static website with local links**. This website will run from the box " +"itself, so all of the images and files required for the website need to be " +"contained within one main folder." +msgstr "" + +#. type: Plain text +#: docs/content-packs/index.mdx:11 +#, markdown-text +msgid "" +"Once you have your static website ready, you will put all of the required " +"files for it in one folder, and place this folder in the **root directory** " +"of your USB drive. This website will be rendered in the browser people use " +"to access the Butter Box portal." +msgstr "" + +#. type: Plain text +#: docs/content-packs/index.mdx:13 +#, markdown-text +msgid "Tips for creating a content pack with a static website:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/index.mdx:20 +#, markdown-text +msgid "" +"**Contents.** Everything for the static website must be stored on a USB " +"drive that plugs into the Butter Box. It should not link to resources on the " +"global internet." +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/index.mdx:20 +#, markdown-text +msgid "" +"**Size.** The size of your content pack is limited by the amount of space " +"available on your USB drive. Though, keep in mind that if multiple people " +"are downloading or watching really large files from the box, there may be " +"some latency." +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/index.mdx:20 +#, markdown-text +msgid "" +"**Pages.** Links between pages should point to other saved pages in the same " +"folder, not to the internet. You must use relative paths " +"(e.g. about/index.html) instead of absolute web URLs." +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/index.mdx:20 +#, markdown-text +msgid "" +"**Media.** Pictures, videos, and sounds cannot be linked to from somewhere " +"online. The files need to be in your website folder and stored on the USB " +"drive." +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/index.mdx:20 +#, markdown-text +msgid "" +"**Libraries.** The website cannot use javascript libraries that rely on an " +"internet connection." +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/index.mdx:20 +#, markdown-text +msgid "" +"**Styles.** Special fonts and icons (like those from Google Fonts) also need " +"to be packed into the folder, not fetched from the web." +msgstr "" + +#. type: Title ### +#: docs/content-packs/index.mdx:21 +#, markdown-text, no-wrap +msgid "Try It" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/index.mdx:24 +#, markdown-text +msgid "" +"The zip file below contains a sample static website. To get a feel for how " +"static websites work with butter—Download it. Unzip it. Then, add this set " +"of files to your USB drive." +msgstr "" + +#. type: Plain text +#: docs/content-packs/index.mdx:26 +#, markdown-text +msgid "[Sample Static Website.zip](/img/docs/Sample%20Static%20Website.zip)" +msgstr "" + +#. type: Plain text +#: docs/content-packs/index.mdx:28 +#, markdown-text +msgid "You can also check out our [New Content Pack News](/blog/tags/contentpack)." +msgstr "" + +#. type: Plain text +#: docs/content-packs/index.mdx:32 +#, markdown-text +msgid "" +"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 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Add website files to a USB drive" +msgstr "" + +#. type: Plain text +#: docs/content-packs/index.mdx:40 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "" +"

USB directory when viewed in Finder on " +"desktop

\n" +msgstr "" + +#. type: Title ### +#: docs/content-packs/index.mdx:43 docs/services/file-sharing.mdx:27 +#, markdown-text, no-wrap +msgid "Connect to your Butter Box to view" +msgstr "" + +#. type: Plain text +#: docs/content-packs/index.mdx:46 +#, markdown-text +msgid "" +"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 +#, markdown-text, no-wrap +msgid "Maps" +msgstr "" + +#. type: Plain text +#: docs/content-packs/maps.mdx:7 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "✅ Steps to Enable Maps" +msgstr "" + +#. type: Plain text +#: docs/content-packs/maps.mdx:15 +#, markdown-text, no-wrap +msgid "**1. Download the map files you need**\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/maps.mdx:18 +#, markdown-text +msgid "" +"Visit: [OsmAnd Local Indexes " +"List](https://osmand.net/list?sortby=size\\&asc=false)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/maps.mdx:18 +#, markdown-text +msgid "Choose and download the regions you want available offline." +msgstr "" + +#. type: Plain text +#: docs/content-packs/maps.mdx:20 +#, markdown-text, no-wrap +msgid "**2. Organize your files**\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/maps.mdx:23 +#, markdown-text +msgid "On your USB drive, create a folder named `osm-map-files` ." +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/maps.mdx:23 +#, markdown-text +msgid "Put the **OsmAnd APK** and all your **map files** into this folder." +msgstr "" + +#. type: Plain text +#: docs/content-packs/maps.mdx:25 +#, markdown-text, no-wrap +msgid "" +"

USB directory when viewed in Finder on " +"desktop

\n" +msgstr "" + +#. type: Plain text +#: docs/content-packs/maps.mdx:27 +#, markdown-text, no-wrap +msgid "**3. Add to your Butter Box**\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/maps.mdx:30 +#, markdown-text +msgid "Insert the USB drive into your Butter Box." +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/maps.mdx:30 +#, markdown-text +msgid "" +"The **Offline Maps** tile will automatically appear in your Butter Box " +"portal." +msgstr "" + +#. type: Plain text +#: docs/content-packs/maps.mdx:32 +#, markdown-text +msgid "" +"👉 That’s it — anyone using an **Android device** can now download OsmAnd and " +"the offline maps you’ve provided directly from your Butter Box." +msgstr "" + +#. type: Plain text +#: docs/content-packs/maps.mdx:33 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "F-Droid Repo" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:9 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Step 1: Install F-Droid Server Tools" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:15 +#, markdown-text +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 +#, markdown-text, 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 +#, markdown-text, 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 +#, markdown-text, no-wrap +msgid "Step 2: Check that it's installed correctly" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:31 +#, markdown-text +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 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Step 3: Create Your Repo Folder" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:41 +#, markdown-text +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 +#, markdown-text, 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 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Step 5: Add your APKs" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:73 +#, markdown-text +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 +#, markdown-text, 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 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Step 6: Generate (and Update) the Repository Index" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:89 +#, markdown-text +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 +#, markdown-text +msgid "What this command does:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/apps/f-droid-repo.mdx:100 +#, markdown-text +msgid "**Scans APKs:** It reads the new files in your repo/ folder." +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/apps/f-droid-repo.mdx:100 +#, markdown-text +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 +#, markdown-text +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 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Step 7: Test your Repo locally" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:104 +#, markdown-text +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 +#, markdown-text, 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 +#, markdown-text +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 +#, markdown-text +msgid "**App Visibility:** Are all your apps appearing in the list?" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/apps/f-droid-repo.mdx:122 +#, markdown-text +msgid "**Visual Assets:** Are icons and screenshots displaying correctly?" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/apps/f-droid-repo.mdx:122 +#, markdown-text +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 +#, markdown-text +msgid "" +"**Functionality:** Do the downloads and installations complete without " +"errors?" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/apps/f-droid-repo.mdx:122 +#, markdown-text +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 +#, markdown-text +msgid "Your repo will be available at:" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:128 +#, markdown-text +msgid "`http://YOUR-IP:8000/repo`" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/f-droid-repo.mdx:132 +#, markdown-text, no-wrap +msgid "**Find your IP:**\n" +msgstr "" + +#. type: Title #### +#: docs/content-packs/apps/f-droid-repo.mdx:133 +#, markdown-text, 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 +#, markdown-text, 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 +#, markdown-text, no-wrap +msgid "Apps" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/index.mdx:7 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "**Things To Know**\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/apps/index.mdx:14 +#, markdown-text +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 +#, markdown-text +msgid "" +"You’ll need a copy of the app’s `.apk` file — make sure it’s from a safe and " +"trusted source." +msgstr "" + +#. type: Bullet: ' * ' +#: docs/content-packs/apps/index.mdx:14 +#, markdown-text +msgid "" +"Butter won’t 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 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "Go Further: Butter Box Supports Sharing Via F-Droid" +msgstr "" + +#. type: Plain text +#: docs/content-packs/apps/index.mdx:18 +#, markdown-text +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 +#, markdown-text +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 +#, markdown-text +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 +#, markdown-text +msgid "What is a F-Ddroid Repo?" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/apps/index.mdx:29 +#, markdown-text +msgid "A hosted library of apps\\ Why use it?" +msgstr "" + +#. type: Bullet: '* ' +#: docs/content-packs/apps/index.mdx:29 +#, markdown-text +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 +#, markdown-text +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 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "How to Reformat Your USB Drive" +msgstr "" + +#. type: Plain text +#: docs/faq/how-to-reformat-your-usb-drive.mdx:7 +#, markdown-text +msgid "" +"After connecting your USB drive to the Raspberry Pi you will see the " +"“Explore USB” title displayed on the portal. If you’ve 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 +#, markdown-text, no-wrap +msgid "![](/img/docs/unknown.png)
\n" +msgstr "" + +#. type: Plain text +#: docs/faq/how-to-reformat-your-usb-drive.mdx:13 +#, markdown-text, 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.
\n" +msgstr "" + +#. type: Plain text +#: docs/faq/how-to-reformat-your-usb-drive.mdx:15 +#, markdown-text, no-wrap +msgid "**Check the Format of the USB**\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:20 +#, markdown-text +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 +#, markdown-text +msgid "Right, or double-click on the USB" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:20 +#, markdown-text +msgid "Click on “Get info” and verify the Format" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:20 +#, markdown-text +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 +#, markdown-text, 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 +#, markdown-text +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 +#, markdown-text +msgid "Click on “Erase Disk…”" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:36 +#, markdown-text +msgid "You can rename your USB at this time" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:36 +#, markdown-text +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 +#, markdown-text +msgid "Then tap “Erase”" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:36 +#, markdown-text +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 +#, markdown-text +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 +#, markdown-text +msgid "Verify the drive is correctly formatted" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:36 +#, markdown-text +msgid "Click on “Get info” and verify the Format
" +msgstr "" + +#. type: Plain text +#: docs/faq/how-to-reformat-your-usb-drive.mdx:38 +#, markdown-text, no-wrap +msgid "**Reformatting Steps on Windows:**\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +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 +#, markdown-text +msgid "" +"You can find this option in the left panel, next to a monitor " +"icon.[\\[2\\]](https://www.wikihow.com/Format-a-Flash-Drive#_note-2)" +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +msgid "On Windows 7, click Computer on the right side of the Start window." +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +msgid "" +"Right-click the flash drive's icon. It's beneath the \"Devices and drives\" " +"heading in the middle of the page. This will bring up a drop-down menu." +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +msgid "Choose \"Format\". This will open the formatting window." +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +msgid "Click on \"File System\" and choose the MS-DOS, FAT32, or exFAT format." +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +msgid "" +"[FAT32](https://www.wikihow.com/Format-FAT32) - The most widely compatible " +"format. Works with most computers and gaming consoles." +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +msgid "" +"exFAT - Similar to FAT32, but designed for external hard drives (e.g., flash " +"drives) and quicker use. It's a universal format that is most common across " +"Windows, Linux, and Mac." +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +msgid "Select \"Start\" and click \"OK\" to finish formatting your flash drive." +msgstr "" + +#. type: Bullet: '* ' +#: docs/faq/how-to-reformat-your-usb-drive.mdx:50 +#, markdown-text +msgid "" +"A final prompt will appear, Click “OK”. Your flash drive has successfully " +"been formatted.
" +msgstr "" + +#. type: Plain text +#: docs/faq/how-to-reformat-your-usb-drive.mdx:52 +#, markdown-text, no-wrap +msgid "" +"![]()![]()![]()\n" +msgstr "" + +#. type: Plain text +#: docs/faq/how-to-reformat-your-usb-drive.mdx:54 +#, markdown-text, no-wrap +msgid "![]()\n" +msgstr "" + +#. type: Plain text +#: docs/faq/how-to-reformat-your-usb-drive.mdx:56 +#, markdown-text, no-wrap +msgid "![]()\n" +msgstr "" + +#. type: Title # +#: docs/faq/index.mdx:4 +#, markdown-text, no-wrap +msgid "FAQ" +msgstr "" + +#. type: Title ### +#: docs/faq/index.mdx:6 +#, markdown-text, no-wrap +msgid "Does the Butter Box give me the internet?" +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:9 +#, markdown-text +msgid "" +"Not quite. The Butter Box doesn’t provide internet access. Instead, it " +"creates its own local Wi-Fi network that lets you access apps, content " +"(previously set up), and message board features offline . Everything is " +"stored and shared locally — no internet or data connection needed." +msgstr "" + +#. type: Title ### +#: docs/faq/index.mdx:12 +#, markdown-text, no-wrap +msgid "How do you power a Butter Box?" +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:15 +#, markdown-text +msgid "" +"The Butter Box is super flexible! You can power it using a USB power bank, a " +"wall adapter, or even a small solar panel. As long as it provides power to " +"the Raspberry Pi, you’re good to go. Go to the [Power " +"Supply](../build-a-box/power-supply) section to learn more." +msgstr "" + +#. type: Title ### +#: docs/faq/index.mdx:18 +#, markdown-text, no-wrap +msgid "If I’m powering the Butter Box with a solar panel, do I need a power bank?" +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:21 +#, markdown-text +msgid "" +"A power bank isn’t strictly required, but it’s highly recommended. Solar " +"panels can be inconsistent — clouds, shade, or changing sunlight can " +"interrupt power. A power bank helps smooth that out by storing energy and " +"keeping the Butter Box running steadily, even when sunlight dips. Check it " +"out this use case to know more: (insert use case URL)" +msgstr "" + +#. type: Title ### +#: docs/faq/index.mdx:24 +#, markdown-text, no-wrap +msgid "" +"What are the security features of the Butter Box? Can I put a password on " +"it?" +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:27 +#, markdown-text +msgid "" +"Currently, the Butter Box broadcasts an open Wi-Fi network — that means no " +"password is required to connect. This makes it easy for people nearby to " +"join, especially in offline or community settings." +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:29 +#, markdown-text +msgid "" +"However, users must either enter the Butter Box’s local IP address manually, " +"or scan a QR code that takes them directly to the content. Since it’s all " +"offline, there’s no exposure to the internet or external threats." +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:31 +#, markdown-text +msgid "" +"You can configure the Raspberry Pi to require a Wi-Fi password in the admin " +"settings. Refer to the [Security](../security) section for more security " +"features." +msgstr "" + +#. type: Title ### +#: docs/faq/index.mdx:34 +#, markdown-text, no-wrap +msgid "How much storage does a Butter Box have?" +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:37 +#, markdown-text +msgid "" +"The Butter Box storage capacity is defined by the microSD card you install — " +"it doesn’t have fixed built-in memory. You can choose anything from a 16 GB " +"card up to 1 TB (the Raspberry Pi Zero 2 W supports microSD sizes up to " +"that). We recommend 256 GB." +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:43 +#, markdown-text, no-wrap +msgid "" +"| Use Case | Suggested micro SD Size |\n" +"| ------------------------------------- | -------------------------- |\n" +"| Basic setup (apps + message board) | 16 GB – 32 GB |\n" +"| Additional content or media storage | 64 GB – 128 GB |\n" +"| Handling large content packs or files | 256 GB or more, up to 1 TB |\n" +msgstr "" + +#. type: Title ### +#: docs/faq/index.mdx:46 +#, markdown-text, no-wrap +msgid "Can I customize it?" +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:49 +#, markdown-text +msgid "" +"Absolutely! You can add, for example, your own content - dropping in PDFs, " +"videos, images, and HTML pages to build a local library, or add your own " +"apps - including Android APKs (even if they’re not on F-Droid)." +msgstr "" + +#. type: Title ### +#: docs/faq/index.mdx:52 +#, markdown-text, no-wrap +msgid "" +"My USB drive is plugged into the Butter Box, but the content is not " +"displayed on the portal. Why?" +msgstr "" + +#. type: Plain text +#: docs/faq/index.mdx:54 +#, markdown-text +msgid "" +"Yout USB drive is probably in the wrong format. Your USB needs to be " +"formatted to ExFat, Fat32, MS-DOS (FAT). Refer to [Reformatting Your " +"USB](how-to-reformat-your-usb-drive) for help." +msgstr "" + +#. type: Title # +#: docs/services/file-sharing.mdx:4 +#, markdown-text, no-wrap +msgid "File Sharing" +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:7 +#, markdown-text, no-wrap +msgid "" +"
\n" +msgstr "" + +#. type: Title ## +#: docs/services/file-sharing.mdx:8 +#, markdown-text, no-wrap +msgid "Share Media, Files and Digital Books" +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:11 +#, markdown-text +msgid "" +"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 +#, markdown-text +msgid "" +"If you’d 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 +#, markdown-text, no-wrap +msgid "Add files to your USB Drive" +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:19 +#, markdown-text +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 +#, markdown-text, no-wrap +msgid "" +"

USB directory when viewed in Finder on " +"desktop

\n" +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:23 +#, markdown-text, no-wrap +msgid "**Things to Know**\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/file-sharing.mdx:26 +#, markdown-text +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 +#, markdown-text +msgid "" +"Organizing content into folders makes it easier for others to browse and " +"download." +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:30 +#, markdown-text +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 " +"the Butter Box portal." +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:32 +#, markdown-text, no-wrap +msgid "" +"
\n" +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:36 +#, markdown-text, no-wrap +msgid "**Troubleshooting**\n" +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:38 +#, markdown-text +msgid "If you don’t see the **Files** tile, try the following actions:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/file-sharing.mdx:42 +#, markdown-text +msgid "Remove the USB drive from the Butter Box. Then re-insert the USB drive." +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/file-sharing.mdx:42 +#, markdown-text +msgid "Turn on/off airplane mode. Reconnect Butter Box wifi." +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/file-sharing.mdx:42 +#, markdown-text +msgid "Refresh the browser page." +msgstr "" + +#. type: Plain text +#: docs/services/file-sharing.mdx:44 +#, markdown-text +msgid "" +"If you are still having trouble you may need to [Reformat Your USB " +"Drive](../faq/how-to-reformat-your-usb-drive)." +msgstr "" + +#. type: Title # +#: docs/services/index.mdx:4 +#, markdown-text, no-wrap +msgid "Features" +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/services/local-chat.mdx:1 +#, no-wrap +msgid "A place for anyone connected to the box to share" +msgstr "" + +#. type: Title # +#: docs/services/local-chat.mdx:6 +#, markdown-text, no-wrap +msgid "Local Chat" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:9 +#, markdown-text +msgid "" +"There is one local chat on your Butter Box that is open to anyone who is " +"able to join the box. If they can open the portal, they can open the chat " +"and say or post anything they want. Depending on your use case, moderation " +"capabilities may be important." +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:11 +#, markdown-text +msgid "First, let's look at what you can and can't do with this local chat." +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:13 +#, markdown-text, no-wrap +msgid "✅ **You Can**
\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:16 +#, markdown-text +msgid "" +"Host videos up to 5 GB PDFs, images, record, audio messages, share " +"pre-recorded audio messages or music" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:16 +#, markdown-text +msgid "" +"Download the full chat or any individual piece of content or media that " +"people have shared" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:18 +#, markdown-text, no-wrap +msgid "❌ **You Cannot**
\n" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:22 +#, markdown-text +msgid "Use the chat to talk with people who are not connected to the Butter Box" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:22 +#, markdown-text +msgid "Get notifications when there are new posts or messages" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:22 +#, markdown-text +msgid "See the messages unless you are connected to the Butter Box" +msgstr "" + +#. type: Title ## +#: docs/services/local-chat.mdx:25 +#, markdown-text, no-wrap +msgid "Moderation" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:28 +#, markdown-text +msgid "" +"A Butter Box offers moderation features for the local chat. In order to " +"access these features, you need to login as the admin of the room." +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:29 +#, markdown-text, no-wrap +msgid "Become the Admin" +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:31 +#, markdown-text, no-wrap +msgid "Logout as Guest" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:34 +#, markdown-text +msgid "" +"When you open the local chat, you are assigned a guest identity. First " +"logout of the account that was created for you." +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:35 +#, markdown-text, no-wrap +msgid "Login as Admin" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:38 +#, markdown-text +msgid "" +"Login to the `butterbox-admin` account. Username and password are both " +"`butterbox-admin`." +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:39 +#, markdown-text, no-wrap +msgid "Change Admin Password" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:42 +#, markdown-text +msgid "" +"Visit your user profile to change the password. At your discretion, you may " +"also wish to change your display name so that other users will recognize " +"you." +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:43 +#, markdown-text, no-wrap +msgid "Moderation Features" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:46 +#, markdown-text +msgid "Once you are an admin, you have access to the following features:" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:54 +#, markdown-text +msgid "**Set a message timer**" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:54 +#, markdown-text +msgid "**Delete messages**" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:54 +#, markdown-text +msgid "**Promote members to moderator or admin**" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:54 +#, markdown-text +msgid "**Kick members out.**" +msgstr "" + +#. type: Bullet: ' * ' +#: docs/services/local-chat.mdx:54 +#, markdown-text +msgid "" +"Keep in mind that someone can simply rejoin as a new guest if they reconnect " +"to the box" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:54 +#, markdown-text +msgid "**Delete the room.**" +msgstr "" + +#. type: Bullet: ' * ' +#: docs/services/local-chat.mdx:54 +#, markdown-text +msgid "" +"Warning: If you delete the room, you will no longer have a local chat on " +"your Butter Box. To get one back, you will have to flash a new image of the " +"Butter Box software to your SD card." +msgstr "" + +#. type: Title ## +#: docs/services/local-chat.mdx:57 +#, markdown-text, no-wrap +msgid "Say Even More—Direct Messages and Private Rooms" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:60 +#, markdown-text +msgid "" +"In addition to the local chat, you can create any number of private rooms " +"from the same interface." +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:61 +#, markdown-text, no-wrap +msgid "Things To Know" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:67 +#, markdown-text +msgid "Each room will have it's own QR code." +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:67 +#, markdown-text +msgid "Private rooms are not discoverable from the Butter Box portal." +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:67 +#, markdown-text +msgid "" +"If you create a private room, you have to share the QR code physically to " +"whomever you want to join **who is also connected to the box.**" +msgstr "" + +#. type: Bullet: '* ' +#: docs/services/local-chat.mdx:67 +#, markdown-text +msgid "" +"Every private chat that you are part of, will be easy for **you** to " +"find. They will all show up in your room list." +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:68 +#, markdown-text, no-wrap +msgid "Instructions" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:71 +#, markdown-text +msgid "" +"You can create a private room from two different places in the message board " +"interface." +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:72 +#, markdown-text, no-wrap +msgid "Open from Avatar Modal" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:75 +#, markdown-text +msgid "Tap on your avatar in the top bar. Select **new room.**" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:78 +#, markdown-text, no-wrap +msgid "" +"| \"\" | |\n" +"| -------------------------------------------------------------------- | - " +"|\n" +msgstr "" + +#. type: Title ### +#: docs/services/local-chat.mdx:81 +#, markdown-text, no-wrap +msgid "Open from Room List" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:84 +#, markdown-text +msgid "" +"Your room list is accessible from your profile page. Once here, select **new " +"room.**" +msgstr "" + +#. type: Plain text +#: docs/services/local-chat.mdx:86 +#, markdown-text, no-wrap +msgid "" +"
\n" +msgstr "" + +#. type: Yaml Front Matter Hash Value: description +#: docs/services/secure-messenger.mdx:1 +#, no-wrap +msgid "Using Delta Chat with a Butter Box" +msgstr "" + +#. type: Title # +#: docs/services/secure-messenger.mdx:6 +#, markdown-text, no-wrap +msgid "Private Messenger" +msgstr "" + +#. type: Plain text +#: docs/services/secure-messenger.mdx:9 +#, markdown-text +msgid "" +"With the Private Messenger service, you can exchange secure messages with " +"people you know. [Delta Chat](https://delta.chat/) is a messaging app that " +"uses email protocols to exchange messages. When used through a Butter Box, " +"people who create accounts on the same Butter Box can send messages to each " +"other without the internet." +msgstr "" + +#. type: Plain text +#: docs/services/secure-messenger.mdx:11 +#, markdown-text +msgid "" +"Think of the Butter Box like a local post office. Whenever you connect to " +"the Box’s network, your Delta Chat app can send outgoing messages and sync " +"to receive any new ones waiting for you." +msgstr ""