{"id":23706937,"url":"https://github.com/Jaennaet/pISSStream","last_synced_at":"2025-09-03T12:32:19.721Z","repository":{"id":268764868,"uuid":"905341353","full_name":"Jaennaet/pISSStream","owner":"Jaennaet","description":"macOS menu bar app that shows how full the International Space Station's urine tank is in real time","archived":false,"fork":false,"pushed_at":"2024-12-25T20:53:18.000Z","size":14,"stargazers_count":652,"open_issues_count":3,"forks_count":14,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-12-25T21:23:42.536Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jaennaet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-18T16:20:56.000Z","updated_at":"2024-12-25T21:22:13.000Z","dependencies_parsed_at":"2024-12-25T21:21:41.849Z","dependency_job_id":null,"html_url":"https://github.com/Jaennaet/pISSStream","commit_stats":null,"previous_names":["jaennaet/pissstream"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaennaet%2FpISSStream","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaennaet%2FpISSStream/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaennaet%2FpISSStream/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaennaet%2FpISSStream/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jaennaet","download_url":"https://codeload.github.com/Jaennaet/pISSStream/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231882156,"owners_count":18440325,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-30T16:00:54.213Z","updated_at":"2025-09-03T12:32:19.612Z","avatar_url":"https://github.com/Jaennaet.png","language":"Swift","readme":"# pISSStream\n\npISSStream 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.\n\n## Official Icon\n\n\u003cimg src=\"pISSStream/Assets.xcassets/AppIcon.appiconset/icon_512x512.png\" alt=\"Launch Image\" width=\"200\" style=\"border-radius: 12px;\" /\u003e\n\n## Features\n\n- Real-time ISS urine tank level monitoring\n- macOS menu bar integration\n- iOS and watchOS app with live updates\n- visionOS immersive 3D visualization\n- **Spatial audio with deep-space soundscape in immersive view**\n- Enhanced UI and custom app icon for Vision Pro\n- Uses NASA's official public ISS telemetry stream via [Lightstreamer](https://lightstreamer.com/)\n\n## Installation\n\n### macOS\n\n![](https://panthercap.us-east.host.bsky.network/xrpc/com.atproto.sync.getBlob?did=did%3Aplc%3Acl3kuq4sxg3jpfjtom4gnamx\u0026cid=bafkreidthbrhc7pjez4g445dpontwyefusimny45kja57twy2obshwtsn4)\n\n[Download](https://github.com/Jaennaet/pISSStream/releases/download/v0.2/pISSStream.0.2.dmg) the latest release DMG.\n\n\n### iOS, watchOS \u0026 visionOS\nDue to Apple's security model, you'll need to build from source and sign with your own developer account:\n\n1. Prerequisites:\n   - Xcode 15.2 or later\n   - Apple Developer account\n   - iOS 17.0+ device for iOS app\n   - Apple Vision Pro or visionOS simulator for spatial computing\n\n2. Build steps:\n```sh\n# Clone the repository\ngit clone https://github.com/Jaennaet/pISSStream.git\ncd pISSStream\n\n# Open in Xcode\nopen pISSStream.xcodeproj\n```\n\n3. In Xcode:\n- Select your development team in the Signing \u0026 Capabilities tab\n- Choose your target device (iPhone/macOS or Vision Pro)\n- Build and run (⌘R)\n\nNote: 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.\n\nFor **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.\n\n## Requirements\n- Mac with Apple silicon\n- Xcode 15.2+\n- Apple Developer Account\n- Vision Pro with developer mode enabled\n- Mac and Vision Pro on same Wi-Fi network\n\n#### Wireless Development\n1. On Vision Pro:\n   - Settings \u003e General \u003e Developer \u003e Enable Developer Mode\n   - Settings \u003e Privacy \u0026 Security \u003e Allow Remote Development\n\n2. Connect Vision Pro:\n   - Open Xcode\n   - Window \u003e Devices and Simulators\n   - Click '+' to add Vision Pro\n   - Follow pairing instructions\n\n3. Build \u0026 Deploy:\n   - Select Vision Pro as build target\n   - Product \u003e Run (⌘R)\n\n#### Common Issues\n- \"Device not found\": Check Wi-Fi connection\n- \"Unauthorized device\": Re-pair Vision Pro\n- \"Build failed\": Update provisioning profile\n- Error \"No paired Vision Pro found\": Ensure Vision Pro is connected and paired\n- \"Invalid signing\": Verify developer account and provisioning profile\n\n## Usage\n\n#### macOS\nWhen 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.\n\n![](https://panthercap.us-east.host.bsky.network/xrpc/com.atproto.sync.getBlob?did=did%3Aplc%3Acl3kuq4sxg3jpfjtom4gnamx\u0026cid=bafkreiaykjgxzlvaf5jjp66uobqlapqcsb2zg7vobs2b47bwf54xnisgma)\n\nIf 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\".\n\n![](https://panthercap.us-east.host.bsky.network/xrpc/com.atproto.sync.getBlob?did=did%3Aplc%3Acl3kuq4sxg3jpfjtom4gnamx\u0026cid=bafkreighfm74uy74zcz4pxk2rw4p5b2ts4tezebtkbyyocngqmyiyvenam)\n\n#### iOS\nLaunch the app to view the current tank level in a simple interface.\n\n![398597279-b5f96dba-3823-4cef-a227-95070cc12e18](https://github.com/user-attachments/assets/afad6330-498e-4fd8-bc22-ab9a4d5bbda9)\n\n\n#### visionOS\nExperience the ISS waste tank in immersive 3D with real-time fill-level visualization.\n\nhttps://github.com/user-attachments/assets/b24c6752-0fb8-4a2e-bf3c-6dab13f2c5e2\n\n\n#### watchOS\nTrack the ISS waste tank fill level in real time — right from your wrist.\n\n\n\nhttps://github.com/user-attachments/assets/f342fc59-0f2e-47db-88f9-d11746a863a2\n\n\n\n\n## But why?\n\nFor some inexplicable reason people keep asking me why I ([@Jaennaet](https://github.com/Jaennaet)) did this.\n\nMy 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.\n\nAlso a great excuse to learn Swift, but the sheer ridiculousness was what drove me.\n\n## Known Issues\n\nNot the epitome of good coding practices since this was my first Swift \u0026 Apple platforms app ever, may break in exciting ways at the slightest excuse.\n\nAt the very least:\n\n- shrugs at stale data\n- Not overly bothered with error handling\n\n## Contributing\nPull requests are welcome for bug fixes.\n\n## Errata\n[@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.\n\nWe will not be adding any of them.\n\n## Contributors\n\n- [@Jaennaet](https://github.com/Jaennaet): initial idea and first version\n- [@durul](https://github.com/durul): code quality, LOS handling, iOS, watchOS \u0026 visionOS versions\n","funding_links":[],"categories":["Swift","Apple Vision"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJaennaet%2FpISSStream","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FJaennaet%2FpISSStream","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJaennaet%2FpISSStream/lists"}