All Applications (20/20 - 100% Complete):
Phase 1 - Core Applications (4/4):
Phase 2 - Cloud Services (8/8):
Phase 3 - Specialized Services (8/8):
An Android application that allows you to share media links from various streaming services and download sources directly to your local services including MeTube, YT-DLP, torrent clients, and jDownloader.
ShareConnect combines the words "share" and "connect" to represent the core functionality of the app - connecting content discovery with local download services.
ShareConnect Wiki: https://deepwiki.com/vasic-digital/ShareConnect
ShareConnect has successfully completed its three-phase development plan with 20 fully-implemented, production-ready applications:
Phase 1 - Core Applications (4):
- ShareConnector: Main application for universal media sharing
- qBitConnect: qBittorrent client integration with modern UI/UX
- TransmissionConnect: Transmission client integration with real-time sync
- uTorrentConnect: uTorrent client integration with enterprise features
Phase 2 - Cloud Services (8):
- JDownloaderConnect: JDownloader integration with MyJDownloader API
- MeTubeConnect: MeTube integration for YouTube downloads and media management
- YTDLPConnect: YT-DLP integration supporting 1800+ streaming sites
- NextcloudConnect: Nextcloud private cloud file management
- FileBrowserConnect: Web-based file management
- PlexConnect: Plex media server integration for streaming and organization
- JellyfinConnect: Jellyfin integration for open-source media streaming
- EmbyConnect: Emby server integration for media management
Phase 3 - Specialized Services (8):
- SeafileConnect: Encrypted cloud storage with AES-256 encryption and library management
- SyncthingConnect: P2P file synchronization with real-time SSE updates
- MatrixConnect: End-to-end encrypted messaging with Olm/Megolm protocols
- PaperlessNGConnect: Document management system with OCR and PDF rendering
- DuplicatiConnect: Backup management with incremental backups and WebSocket monitoring
- WireGuardConnect: VPN configuration manager with QR code support
- MinecraftServerConnect: Minecraft server management via RCON protocol
- OnlyOfficeConnect: Collaborative document editing with real-time synchronization
Project Statistics:
- Total Applications: 20 (100% complete)
- Total Tests: 1,581+ (81%+ coverage)
- Documentation: 10,000+ lines
- Sync Modules: 8 (synchronized across all apps)
Unified Sharing Philosophy: "Discover content anywhere → Share once → Connect to any service"
See PHASE_3_MASTER_INDEX.md for complete Phase 3 documentation.
- Multi-Service Support: Share to MeTube, YT-DLP, qBittorrent, Transmission, uTorrent, and jDownloader
- Universal Media Sharing: Share content from YouTube, Vimeo, Twitch, Reddit, Twitter, Instagram, Facebook, SoundCloud and more
- Magnet Link Support: Directly add magnet links to torrent clients
- Multiple Service Profiles: Support for multiple service profiles with default profile selection
- Authentication Support: Optional username and password authentication for protected services
- Clipboard URL Sharing: Share URLs directly from clipboard
- System App Integration: Share links to compatible installed applications
- Customizable Themes: 6 built-in color schemes with light/dark variants (Warm Orange, Crimson, Light Blue, Purple, Green, Material) plus user-created custom themes
- Theme Creator: Create and customize your own themes with full color control
- Design custom color schemes with primary, secondary, background, and surface colors
- Real-time preview of theme changes
- Edit existing themes or create new ones
- Custom themes sync across all ShareConnect apps instantly
- Comprehensive theme management in Settings
- Encrypted Storage: All data stored with Room database and SQLCipher encryption
- Rich Media Metadata: Automatic fetching of titles, descriptions, and thumbnails for shared URLs
- Visual Profile Management: Modern grid layout with profile icons, default indicators, and lock badges for authenticated profiles
- Comprehensive History: Detailed sharing history with media metadata, filtering by service, type, and profile
- Modern Material Design: Beautiful UI following Material Design 3 guidelines with proper layout behaviors
- Unified Design System: Consistent design tokens, reusable components, and smooth animations across all apps
- Connection Testing: Built-in service connection testing with enhanced authentication support
- Quick Access: Direct access to service interfaces from multiple locations
- Bulk Cleanup: Flexible history cleanup options (individual items, by service, by type, or all)
- Custom Theme Creator: Create, edit, and delete custom themes with full color customization
- Design your own color schemes with 30+ color parameters
- Real-time preview of your custom themes
- Edit existing themes or create new ones from scratch
- Custom themes sync across all ShareConnect apps in real-time
- Comprehensive theme management in Settings
- Enhanced Theme System:
- Extended theme data model with custom color support
- Improved theme selection UI with custom theme indicators
- Better theme sync performance and reliability
- Full backward compatibility with existing themes
- Profile Database Migration: Profiles now stored in encrypted Room database alongside history
- Enhanced Main Screen:
- Grid layout showing all configured profiles with icons
- Quick access to system apps that can handle media links
- Visual indicators for default profiles and authenticated services
- Long-press context menu for profile management
- Improved Authentication:
- Fixed qBittorrent 403 errors with proper cookie-based authentication
- Enhanced Transmission support with session ID handling
- Better jDownloader API implementation
- Rich Media Metadata:
- Automatic fetching of titles, descriptions, and thumbnails
- Support for all major streaming platforms
- Fallback extraction for unsupported sites
- UI/UX Improvements:
- Fixed layout spacing between title and navigation bars
- Modern Material Design 3 components throughout
- Smooth animations and transitions
- Comprehensive Testing: 106 comprehensive tests with complete automation validation including:
- Multi-app synchronization scenarios
- Real-time sync validation
- Object lifecycle management
- Performance validation under load
ShareConnect works with all streaming services and download sources supported by your target services:
For services that require authentication, ShareConnect supports optional username and password configuration:
- Configure username and password in each service profile
- Credentials are stored securely in Room database with SQLCipher encryption
- Enhanced authentication support:
- qBittorrent: Cookie-based authentication with automatic login
- Transmission: Session ID handling with automatic retry
- jDownloader: My.JDownloader API with fallback to legacy API
- Basic Auth: Standard HTTP basic authentication for other services
- Visual lock indicator on profiles with credentials
- All authentication data follows the same privacy policies (no data leaves the device without user action)
- YouTube
- Vimeo
- Dailymotion
- Twitch
- Twitter/X
- SoundCloud
- Bandcamp
- And dozens of other sites supported by yt-dlp
- Magnet Links
- Torrent Files
- HTTP(S) links to torrent files
- Streaming Services: YouTube, Vimeo, Twitch, TikTok, Instagram, Facebook, Twitter/X, Reddit, SoundCloud, and 1800+ other sites
- File Hosting Services: MediaFire, Mega.nz, Google Drive, Dropbox, OneDrive, Box, pCloud, and more
- Premium Link Services: RapidGator, Uploaded.net, Nitroflare, FileFactory, Fileboom, Keep2Share, and more
- Container Formats: DLC, RSDF, CCF (JDownloader container formats)
- Archive Files: RAR, 7Z, ZIP, TAR, and other compressed formats
- Direct Downloads: Any HTTP/HTTPS/FTP download link
- Install the app on your Android device
- Open the app and configure your service profiles:
- Go to Settings > Server Profiles
- Add new profiles for each service you want to use
- Select the appropriate service type (MeTube, YT-DLP, Torrent Client, jDownloader)
- For Torrent Clients, specify which client you're using
- If your service requires authentication, enter your username and password (optional)
- Set one profile as default for quick sharing
- Test your connections to ensure services are reachable
- (Optional) Customize the app theme in Settings > Theme
- Open any supported media app or website (YouTube, Vimeo, Twitch, etc.)
- Find content you want to download
- Tap the share button
- Select "ShareConnect" from the sharing options
- Choose your service profile (if you have multiple)
- Tap "Send to Service"
- The app will automatically open your service interface in the browser
- Copy any supported URL to clipboard
- Open ShareConnect app
- Tap the "Add" button (floating action button)
- The URL from clipboard will be automatically detected
- Choose your service profile
- Tap "Send to Service"
- The app will automatically open your service interface in the browser
- Open any supported media app or website
- Find content you want to download
- Tap the share button
- Select "ShareConnect" from the sharing options
- Instead of selecting a ShareConnect profile, tap "Share to Apps"
- Choose from the list of compatible installed applications
- The link will be sent directly to the selected application
- Access history through the main menu or toolbar
- Filter by service provider or media type
- Resend any item to any profile or system app
- Delete individual items or use bulk cleanup options
- Go to Settings > Theme
- Choose from 6 color schemes
- Select light or dark variant
- Theme is applied immediately and saved for future sessions
- Android 8.0 (API level 26) or higher
- Running service instances accessible from your device:
- MeTube or YT-DLP (optional)
- Torrent Client with Web UI (qBittorrent, Transmission, or uTorrent)
- jDownloader with Web UI (optional)
To build the application:
./gradlew assembleDebugThe APK will be generated in app/build/outputs/apk/debug/app-debug.apk
Alternatively, you can use the provided build script:
./build_app.shThis script will clean the project, build the debug APK, and provide useful information about the build.
You can also build directly with Gradle if installed:
gradle assembleDebug- Supporting Colors: Blue (#2196F3) and White (#FFFFFF)
- Adaptive Icons: Properly scaled for all Android devices
- Splash Screen: Themed loading screen with logo
All branding assets are available in the Branding directory.
- Room Database: Local data storage with SQLCipher encryption
- History Items: Complete tracking of shared links with metadata
- Themes: Persistent theme preferences
- Profiles: Service profile management
- Encrypted Storage: All sensitive data encrypted at rest
- Secure Networking: HTTPS support for service communications
- Data Privacy: No data leaves the device without user action
- Material Design 3: Modern UI following Google's latest guidelines
- Adaptive Layouts: Responsive design for all screen sizes
- Theme Support: Dynamic theme switching with day/night mode
- Intuitive Navigation: Clear navigation patterns and user flows
Visit our enterprise-grade website for real-time project health monitoring:
- Live Health Dashboard: Testing, security, and code quality metrics
- Application Ecosystem: Overview of all 5 Android applications
- Quality Metrics: Comprehensive badges and status indicators
- Interactive Design: Modern, responsive UI with smooth animations
Website URL: https://yourusername.github.io/ShareConnect
- Documentation Index: Complete navigation guide
- Sync Architecture: Technical architecture details
- Implementation Report: Complete implementation details
ShareConnect includes comprehensive testing infrastructure with enterprise-grade code quality analysis:
./run_all_tests.sh- Run complete test suite including SonarQube analysis./run_unit_tests.sh- Run unit tests./run_instrumentation_tests.sh- Run instrumentation tests./run_automation_tests.sh- Run automation tests./run_full_app_crash_test.sh- Run crash tests./run_ai_qa_tests.sh- Run AI-powered QA tests./run_sonarqube_tests.sh- Run SonarQube code quality analysis
- Dockerized Infrastructure: Pre-configured SonarQube server with PostgreSQL
- Non-blocking Execution: Asynchronous container management
- Comprehensive Analysis: Kotlin, Java, Android-specific rules
- Quality Gates: Automated pass/fail criteria
- Auto-fixing: Automated resolution of common issues
# Start containers
./run_sonarqube_tests.sh --async
# Check status
./run_sonarqube_scan.sh --status
# Run analysis
./run_sonarqube_tests.sh
# Access UI
open http://localhost:9001View comprehensive test reports in Documentation/Tests/ directory including:
- Unit test results and coverage
- AI QA comprehensive test reports (100% success rate)
- SonarQube code quality analysis
- Performance metrics and trends
- Crash test summaries
- Test Coverage: 100% for AI QA scenarios
- Code Quality: A+ grade with SonarQube integration
- Performance: Excellent across all benchmarks
- Stability: Comprehensive crash testing validation
Feel free to fork this project and submit pull requests for improvements or bug fixes.
This project is licensed under the MIT License - see the LICENSE file for details.
- MeTube - Self-hosted YouTube downloader
- yt-dlp - Media download engine
- qBittorrent - Free BitTorrent client
- Transmission - Fast, easy, free BitTorrent client
- uTorrent - Proprietary BitTorrent client
- jDownloader - Free download manager
- Android Jetpack - Android development components
- Material Design - Design system by Google
