pISSStream

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 1,906 Open GitHub ↗

App that shows how full the International Space Station's urine tank is in real time, available for macOS (menu bar), iOS, watchOS and visionOS

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# pISSStream

pISSStream is a menu bar app that shows the International Space Station's urine tank's capacity in real-time. It is available for macOS, watchOS, iOS, and visionOS.

## Official Icon

## Features

- Real-time ISS urine tank level monitoring
- macOS menu bar integration
- iOS and watchOS app with live updates
- visionOS immersive 3D visualization
- **Spatial audio with deep-space soundscape in immersive view**
- Enhanced UI and custom app icon for Vision Pro
- Uses NASA's official public ISS telemetry stream via [Lightstreamer](https://lightstreamer.com/)

## Installation

### macOS

![](https://panthercap.us-east.host.bsky.network/xrpc/com.atproto.sync.getBlob?did=did%3Aplc%3Acl3kuq4sxg3jpfjtom4gnamx&cid=bafkreidthbrhc7pjez4g445dpontwyefusimny45kja57twy2obshwtsn4)

[Download](https://github.com/Jaennaet/pISSStream/releases/download/v0.3/pISSStream.dmg) the latest release DMG.

### iOS, watchOS & visionOS
Due to Apple's security model, you'll need to build from source and sign with your own developer account:

1. Prerequisites:
   - Xcode 15.2 or later
   - Apple Developer account
   - iOS 17.0+ device for iOS app
   - Apple Vision Pro or visionOS simulator for spatial computing

2. Build steps:
```sh
# Clone the repository
git clone https://github.com/Jaennaet/pISSStream.git
cd pISSStream

# Open in Xcode
open pISSStream.xcodeproj
```

3. In Xcode:
- Select your development team in the Signing & Capabilities tab
- Choose your target device (iPhone/macOS or Vision Pro)
- Build and run (⌘R)

Note: If you don't have an Apple Developer account, you can still run the app in the simulator or on your device for up to 7 days using a free provisioning profile.

For **visionOS** development, you'll need the visionOS SDK installed in Xcode. The app uses the ImmersiveSpace API for the 3D visualization experience and features spatial audio for enhanced immersion.

## Requirements
- Mac with Apple silicon
- Xcode 15.2+
- Apple Developer Account
- Vision Pro with developer mode enabled
- Mac and Vision Pro on same Wi-Fi network

#### Wireless Development
1. On Vision Pro:
   - Settings > General > Developer > Enable Developer Mode
   - Settings > Privacy & Security > Allow Remote Development

2. Connect Vision Pro:
   - Open Xcode
   - Window > Devices and Simulators
   - Click '+' to add Vision Pro
   - Follow pairing instructions

3. Build & Deploy:
   - Select Vision Pro as build target
   - Product > Run (⌘R)

#### Common Issues
- "Device not found": Check Wi-Fi connection
- "Unauthorized device": Re-pair Vision Pro
- "Build failed": Update provisioning profile
- Error "No paired Vision Pro found": Ensure Vision Pro is connected and paired
- "Invalid signing": Verify developer account and provisioning profile

## Usage

#### macOS
When pISSStream can connect to Lightstreamer and the ISS telemetry signal is being received by the ground station, the menu bar item shows 🧑🏽‍🚀🚽 alongside the fill percentage, and the app icon reflects the latest UI enhancements.

![](https://panthercap.us-east.host.bsky.network/xrpc/com.atproto.sync.getBlob?did=did%3Aplc%3Acl3kuq4sxg3jpfjtom4gnamx&cid=bafkreiaykjgxzlvaf5jjp66uobqlapqcsb2zg7vobs2b47bwf54xnisgma)

If either the connection to Lightstreamer or the ISS telemetry signal itself is lost, the menu bar item shows 🧑🏽‍🚀❗and the last received value if any, and the menu reads either "Connecting" or "No Signal".

![](https://panthercap.us-east.host.bsky.network/xrpc/com.atproto.sync.getBlob?did=did%3Aplc%3Acl3kuq4sxg3jpfjtom4gnamx&cid=bafkreighfm74uy74zcz4pxk2rw4p5b2ts4tezebtkbyyocngqmyiyvenam)

#### iOS
Launch the app to view the current tank level in a simple interface.

![398597279-b5f96dba-3823-4cef-a227-95070cc12e18](https://github.com/user-attachments/assets/afad6330-498e-4fd8-bc22-ab9a4d5bbda9)

#### visionOS
Experience the ISS waste tank in immersive 3D with real-time fill-level visualization.

https://github.com/user-attachments/assets/b24c6752-0fb8-4a2e-bf3c-6dab13f2c5e2

#### watchOS
Track the ISS waste tank fill level in real time — right from your wrist.

https://github.com/user-attachments/assets/f342fc59-0f2e-47db-88f9-d11746a863a2

## But why?

For some inexplicable reason people keep asking me why I ([@Jaennaet](https://github.com/Jaennaet)) did this.

My motivation was entirely that I thought this was both a hilariously stupid use of a space station's telemetry stream, but also kind of amazing at the same time. It's remarkable that we live in a world where it takes an afternoon to bang out a joke application that reads actual realtime telemetry data from a space station's toilets.

Also a great excuse to learn Swift, but the sheer ridiculousness was what drove me.

## Known Issues

Not the epitome of good coding practices since this was my first Swift & Apple platforms app ever, may break in exciting ways at the slightest excuse.

At the very least:

- shrugs at stale data
- Not overly bothered with error handling

## Contributing
Pull requests are welcome for bug fixes.

## Errata
[@Jaennaet](https://github.com/Jaennaet) found out about the data stream from https://iss-mimic.github.io/Mimic/, which has considerably more and more interesting stats than just how full the piss tank is.

We will not be adding any of them.

## Contributors

- [@Jaennaet](https://github.com/Jaennaet): initial idea and first version
- [@durul](https://github.com/durul): code quality, LOS handling, iOS, watchOS & visionOS versions

pISSStream

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README