📱 How to Get Logs from the zeitkapsl App (Android)

If something isn’t working in the app, you can help us by sending a debug log from your Android device. This guide shows how to do that using a tool called adb (Android Debug Bridge).

This process is a bit technical. Follow the steps carefully, and contact us if you get stuck.

✅ What you need

An Android phone or tablet
A computer (Windows, macOS, or Linux)
A USB cable
The tool adb

🧰 Step 1: Install adb

Option A: Manual download

Go to https://developer.android.com/studio/releases/platform-tools
Download the ZIP file for your operating system
Unzip it to a known folder (e.g. Desktop or Downloads)

Option B: Install with Scoop (Windows only)

Open PowerShell (not as Administrator)
Install Scoop if you haven’t already:
```
iwr -useb get.scoop.sh | iex
```
Add the extras bucket:
```
scoop bucket add extras
```
Install adb:
```
scoop install adb
```
Check it works:
```
adb version
```

🔓 Step 2: Enable USB debugging on your phone

Open Settings
Go to About phone
Tap Build number seven times to enable developer mode
Go back, open System > Developer options
Enable USB debugging

🔌 Step 3: Connect your phone

Plug your phone into your computer with a USB cable
If prompted on your phone, tap Allow for USB debugging

🖥️ Step 4: Open Terminal or PowerShell

macOS / Linux:

cd ~/Downloads/platform-tools

Windows (manual install):

cd C:\Users\YourName\Downloads\platform-tools

Skip this if you installed adb with Scoop — it’s already in your path.

📋 Step 5: Capture logs for zeitkapsl

Start capturing logs and filter for our app’s package name:

macOS / Linux:

./adb logcat | grep eu.zeitkapsl.app > zeitkapsl-log.txt

Windows:

adb logcat | findstr eu.zeitkapsl.app > zeitkapsl-log.txt

🚨 Step 6: Reproduce the issue

Open the zeitkapsl app on your phone
Wait for the issue or crash to happen
Once it occurs, return to the terminal and press Ctrl + C to stop logging

This will save the logs to a file named zeitkapsl-log.txt.

📧 Step 7: Send us the logs

Please send the file zeitkapsl-log.txt to our support team. We will only use it to investigate technical errors — it does not contain your photos or personal data.

Need help?

If you get stuck at any step, feel free to contact us via support@zeitkapsl.eu. We’re happy to assist.

Android debugging