A Material You-focused Flutter app that lets you track your Discord activity and keep an eye on your friends' status. Snooper leverages the Lanyard API to provide real-time presence information with a clean, modern UI.
Simply join this Discord server and your presence will be instantly available in the app. Snooper utilizes the Lanyard API (GET api.lanyard.rest/v1/users/:your_id) to fetch real-time presence data.
- Real-time Status Updates: See what your friends are playing, listening to, or doing on Discord
- Material You Design: Adaptive theming that matches your device's wallpaper
- Offline Support: View previously cached data even when offline
- Quick Profile Sharing: Easily share profiles with friends
- Background Notifications: Get notified when friends come online or start activities
- Customizable UI: Personalize the app with color themes and layout options
Snooper uses a combination of local storage and temporary cloud storage via THE NULL POINTER:
Data Retention Policy
====================
Local data: Cached indefinitely until app data is cleared
Cloud data: Follows Lanyard API storage policies
Temporary data storage file via THE NULL POINTER (JSON file):
- Gamification: Earn points and badges for tracking activities
- Snapshot History: Archive and view historical presence data
- Enhanced Notifications: More granular control over notifications
- Localizations: Support for multiple languages
- UI Improvements: More customization options and themes
- Bug Fixes: Continuous improvements and stability enhancements
- Friends Grouping: Organize friends into custom categories
- Statistics Dashboard: View analytics about your Discord usage patterns
<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS" tools:ignore="ProtectedPermissions" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" tools:ignore="QueryAllPackagesPermission" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />This project is built with Flutter. To run it on your local machine, follow these steps:
- Install Flutter
- Set up an Android emulator or connect a physical device
- Enable Developer options and USB debugging on your device
-
Clone the repository:
git clone https://github.com/Anslem27/snooper.git cd Snooper -
Install dependencies:
flutter pub get
-
Run the application:
flutter run
flutter build apk --releaseOr for app bundles:
flutter build appbundle
Snooper follows a minimalistic approach:
- Provider for state management (not fully implemented)
- Background services using Workmanager for notifications
- Permission Issues: Make sure to grant all required permissions in your device settings
- Discord Server: You must join the Lanyard Discord server for the API to track your presence
- Background Services: On some devices, you may need to disable battery optimization for the app
For Flutter development help:
Contributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Please ensure your code adheres to the project's coding standards and includes appropriate tests.
GNU General Public License, version 3.0 © Anslem
Copyright 2022 - 2025 Anslem Seguya
Licensed under the GNU General Public License, version 3.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.gnu.org/licenses/gpl-3.0.en.html
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Check your Discord activity and keep an eye on your friends - all with a beautiful Material You design!