StreamShield

A React Native/Expo mobile app that protects your Spotify listening activity from influencing recommendations through intelligent playlist management and signal dilution.

Features

• Activate a "shield" to protect your listening sessions
• Add tracks to a special playlist excluded from recommendations
• Manage rules and session durations
• View listening stats and history
• Modern React Native/Expo app with TypeScript

Setup Instructions

1. Clone the repository:

   git clone <your-repo-url>
   cd rork-streamshield

2. Install dependencies:

   npm install

3. Set up environment variables:

   • Add your Spotify Client ID to app.json under extra.EXPO_PUBLIC_SPOTIFY_CLIENT_ID.
   • Make sure to add your redirect URI to your Spotify Developer Dashboard.

4. Start the app:

   npm start

   • For web: npm run start-web

Usage

• Log in with your Spotify account.
• Activate the shield to start a protected session.
• Use the app to manage your rules and view stats.
• Copy and add the provided redirect URI to your Spotify app settings if prompted.

Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a new branch for your feature or bugfix
3. Make your changes and add tests if applicable
4. Submit a pull request with a clear description

License

MIT

---

Automated PRs & BugBot Review

• When you push to any branch except main, a GitHub Actions workflow will automatically create a Pull Request to main.
• BugBot (if enabled in the Cursor dashboard) will review all PRs automatically and add comments or flag issues.
• To configure BugBot, visit the Cursor dashboard and set preferences for when it should run (e.g., only on PRs).
• You will be notified in the PR when BugBot has completed its review.