User Manual

1. Quick Start

Prepare USB Stick

Create an AutoPlayFile folder and copy your images, videos, and logo into it.

Plug In & Go

Insert the USB stick into your Android device. KioskPilot detects it automatically and copies the content.

Enjoy Your Display

Your slideshow and videos start playing automatically with smooth crossfade transitions.

2. USB Stick Setup

KioskPilot reads all its content from a single folder on your USB stick. The folder must be named AutoPlayFile and placed at the root of the USB drive.

Folder Structure

USB Drive (root)
└── AutoPlayFile/
    ├── config.txt              ← Configuration (optional)
    ├── logo_banner.png         ← Logo (any file starting with "logo")
    ├── logo_secondary.jpg      ← Second logo (auto-rotates)
    ├── photo1.jpg              ← Images for slideshow
    ├── photo2.png
    ├── brochure.webp
    ├── product_video.mp4       ← Videos for loop
    └── demo.mov

Logo files: Any image file whose name starts with logo (e.g., logo.png, logo_banner.jpg). If you have multiple logos, they rotate automatically with a crossfade effect.

Image files: All image files that do not start with logo are treated as slideshow images. They are sorted alphabetically and displayed with crossfade transitions.

Video files: All video files play sequentially in a loop. When the last video ends, playback starts again from the first.

Tip: The app handles image EXIF rotation and video rotation metadata automatically. You don't need to pre-rotate your files.

3. Supported Media Formats

Images

.jpg .jpeg .png .gif .webp .bmp

Videos

.mp4 .webm .mkv .avi .mov

For best results, encode videos at 1080px width using H.264 (MP4).

4. Configuration File (config.txt)

You can configure KioskPilot by placing a config.txt file inside the AutoPlayFile folder on your USB stick. This is optional — you can also configure everything through the on-device Settings screen.

Example config.txt

# KioskPilot Configuration
# Lines starting with # are comments.
# All durations are in seconds.
# Use \n for line breaks in footer text.

slideshow_duration=15
logo_duration=10
footer_duration=10
mute=true

layout_mode=split
video_position=bottom
split_ratio=0.5
screen_orientation=portrait

background_color=#000000
logo_bar_color=#FFFFFF
footer_bar_color=#FFFFFF
footer_text_color=#1B3A5C
footer_font=sans-serif-medium
footer_font_size=22

footer_text=Staubfreies Heu und Stroh\nfür gesunde und leistungsstarke Pferde.
footer_text_2=Qualität seit über 30 Jahren.

Complete Reference

Timing

Key	Default	Description
`slideshow_duration`	15	Seconds each image is shown (5–60)
`logo_duration`	10	Seconds per logo when rotating multiple logos (3–60)
`footer_duration`	10	Seconds per footer text when rotating multiple texts (3–60)
`mute`	true	Mute video audio on start (`true` / `false`)

Layout

Key	Default	Description
`layout_mode`	auto	`auto`, `split`, `images_only`, or `videos_only`
`video_position`	bottom	In split mode: `top` or `bottom`
`split_ratio`	0.5	Image/video size ratio (0.1–0.9). E.g., 0.7 = 70% images, 30% video
`screen_orientation`	auto	`auto`, `portrait`, or `landscape`

Appearance

Key	Default	Description
`background_color`	#000000	Screen background color (hex)
`logo_bar_color`	#FFFFFF	Logo area background color (hex)
`footer_bar_color`	#FFFFFF	Footer area background color (hex)
`footer_text_color`	#1B3A5C	Footer text color (hex)
`footer_font`	sans-serif-medium	Footer font family (Android system fonts)
`footer_font_size`	22	Footer text size in sp

Footer Text

Key	Description
`footer_text`	Primary footer text. Use `\n` for line breaks.
`footer_text_2`	Second footer text (auto-rotates with primary).
`footer_text_N`	Any key starting with `footer_text` is collected and cycled.

If you define multiple footer texts, they rotate automatically with a crossfade transition at the interval set by footer_duration.

5. On-Device Settings

You can configure all settings directly on the device through the Settings screen. Tap anywhere on the display to show the control bar, then tap the gear icon to open Settings.

Settings configured on the device are also saved back to config.txt, so they persist across USB updates. If a config.txt exists on the USB stick, it is imported automatically on first launch.

Kiosk Settings

Slideshow Duration

How long each image is displayed (5–60 seconds). Drag the slider to adjust.

Logo Duration

How long each logo is shown before rotating to the next (3–60 seconds). Only relevant when you have multiple logo files.

Footer Duration

How long each footer text is shown before rotating (3–60 seconds). Only relevant with multiple footer texts.

Mute Audio on Start

When checked, video audio is muted when the app starts. You can toggle audio from the control bar at any time.

Layout Mode

auto (adapts to content), split (images + video), images_only, or videos_only.

Video Position

In split mode, choose whether video appears at the top or bottom of the screen.

Image/Video Split Ratio

Drag to control how much screen space goes to images vs. video. 50/50 is the default.

Screen Orientation

auto, portrait, or landscape. Locks the display to your chosen orientation.

6. Appearance & Branding

Scroll down in the Settings screen to find the Appearance section, where you can fully customize colors, fonts, and footer text to match your brand.

Color Customization

Background Color: The main screen background behind your content.

Logo Bar Background: The background color of the logo area at the top of the screen.

Footer Bar Background: The background color of the footer text area at the bottom.

Each color picker features a rainbow hue carousel and a light/dark shade slider. You can also type a hex color code directly.

Footer Text & Font

Footer Text Color: The color of your footer text.

Footer Font: Choose from available Android system fonts.

Footer Font Size: Adjust the text size (in sp).

Footer Texts: Add, edit, or remove footer text entries. Multiple entries auto-rotate. Use Enter for line breaks within a single entry. Tap + Add Footer Text to add more.

Tap Save & Return to apply your changes. Settings are saved to both the device and config.txt.

7. Layout Modes

Auto

Automatically adapts based on your content. If you have both images and videos, it uses split view. If only images or only videos, it fills the full screen.

Split

Displays images and videos simultaneously on screen, split by the configured ratio. Choose whether video goes on top or bottom.

Images Only

Full-screen image slideshow. Videos are ignored even if present on the USB stick.

Videos Only

Full-screen video loop. Images are ignored even if present on the USB stick.

8. On-Screen Controls

Tap anywhere on the screen to reveal the control bar. It auto-hides after 5 seconds of inactivity.

⚙ Settings

Opens the full Settings screen.

Q — Quit

Exits the kiosk app.

− / Duration / +

Decrease or increase slideshow duration by 5 seconds. The current duration is shown in the center.

🔇 Audio Mute

Toggle video audio on or off.

↻ Refresh

Manually trigger a content reload from USB.

9. Updating Content

To update the content on your display:

Update the files in the AutoPlayFile folder on your USB stick.
Insert the USB stick into the Android device.
The app automatically detects the USB and copies the new content.
If the USB was already inserted, tap the screen to show the control bar, then tap UPD to reload.

Note: The USB copy replaces all content in the app's internal storage. If you remove a file from the USB, it will also be removed from the display after the next update.

10. Kiosk Mode (Lock Screen)

For trade shows and public displays, you can lock the device so that pressing the Home button always returns to KioskPilot instead of the Android launcher.

This requires a one-time setup via ADB (Android Debug Bridge) from a computer:

Enable kiosk mode:

adb shell cmd package set-home-activity com.tradeshow.kiosk/.MainActivity

Disable kiosk mode (restore normal launcher):

adb shell cmd package set-home-activity com.android.launcher3/.Launcher

The app also starts automatically when the device boots, so after a power cycle it goes straight into display mode.

11. Tips & Troubleshooting

Video Performance

For smooth playback, encode videos at 1080px width. Large 4K files waste storage and may stutter on lower-end devices. Use H.264 (MP4) for maximum compatibility.

Logo Not Showing?

Make sure the filename starts with logo (e.g., logo.png, logo_banner.jpg). Files that don't start with "logo" are treated as slideshow images.

USB Not Detected?

The USB stick must have a folder named exactly AutoPlayFile at the root level. Check spelling and capitalization. Try unplugging and re-inserting the stick.

Footer Text Not Appearing?

Make sure footer_text=... is defined in your config.txt, or add footer texts through the Settings screen. After updating config.txt on the USB, tap UPD to reload.

Contents