|
1 | | -# serial_stream |
| 1 | +# Serial Stream |
2 | 2 |
|
3 | | -An App to show you free TV serials, Movies etc. |
| 3 | +A Flutter application for streaming TV series and movies. |
| 4 | + |
| 5 | +## Description |
| 6 | +Serial Stream is a mobile application built with Flutter that allows users to watch TV series and movies. The app fetches content by web scraping from [DesiTellyBox](http://desitellybox.to/), providing access to a wide range of TV shows, movies, and web series. The app provides a user-friendly interface for browsing and streaming content. |
| 7 | +[GET KNOW MORE ABOUT SERIAL STREAM](https://somnathdashs.github.io/apps/serial_stream/) |
| 8 | + |
| 9 | +Note: Since the app relies on web scraping, there might be occasional failures in content fetching due to: |
| 10 | +- Changes in the source website's structure |
| 11 | +- Network connectivity issues |
| 12 | +- Source website maintenance or downtime |
| 13 | +- Rate limiting or access restrictions |
| 14 | + |
| 15 | +## Features |
| 16 | +- Browse TV series and movies |
| 17 | +- Stream content directly in the app |
| 18 | +- User-friendly interface |
| 19 | +- Cross-platform support ( Android, Windows) |
| 20 | + |
| 21 | +## Software Requirements |
| 22 | +- Flutter SDK: ^3.5.3 |
| 23 | +- Dart SDK: ^3.5.3 |
| 24 | +- Android Studio / VS Code with Flutter extensions |
| 25 | +- Windows 11 (Version 10.0.26100) |
| 26 | + |
| 27 | +## Dependencies |
| 28 | +The project uses the following main libraries: |
| 29 | +- `http` - For making HTTP requests |
| 30 | +- `html` ^0.15.0 - For HTML parsing |
| 31 | +- `webview_flutter` ^4.10.0 - For web content display |
| 32 | +- `feedback` ^3.1.0 - For user feedback |
| 33 | +- `firebase_core` ^3.13.0 - For Firebase integration |
| 34 | +- `firebase_messaging` ^15.2.5 - For push notifications |
| 35 | +- `cloud_firestore` ^5.6.6 - For cloud database |
| 36 | +- `video_player` - For video playback |
| 37 | +- `better_player_plus` - For enhanced video playback |
| 38 | +- `cached_network_image` ^3.4.1 - For image caching |
| 39 | +- `shared_preferences` ^2.5.3 - For local storage |
| 40 | +- `connectivity_plus` ^6.1.3 - For network status |
| 41 | +- `url_launcher` ^6.3.1 - For opening URLs |
| 42 | +- `share_plus` ^10.1.4 - For sharing content |
| 43 | + |
| 44 | +For a complete list of dependencies, check the [pubspec.yaml](https://github.com/somnathdashs/Serial_Stream/blob/main/pubspec.yaml) file. |
4 | 45 |
|
5 | 46 | ## Getting Started |
| 47 | +To get started with Serial Stream development: |
| 48 | + |
| 49 | +1. Set up your development environment: |
| 50 | + - Install Flutter SDK from [flutter.dev](https://flutter.dev/docs/get-started/install) |
| 51 | + - Set up your preferred IDE (Android Studio or VS Code) |
| 52 | + - Configure Flutter and Dart plugins in your IDE |
| 53 | + - The release version have intregated firebase project to make user up-to-date and track them. But obviously, the google-servise.config file is not included. If you want to fork it then you can add your own one. |
| 54 | + |
| 55 | + |
| 56 | +### Prerequisites |
| 57 | +- Flutter SDK (latest version) |
| 58 | +- Dart SDK (latest version) |
| 59 | +- Android Studio / VS Code with Flutter extensions |
| 60 | + |
| 61 | +### Installation |
| 62 | +1. Clone the repository: |
| 63 | +```bash |
| 64 | +git clone https://github.com/yourusername/serial_stream.git |
| 65 | +``` |
| 66 | + |
| 67 | +2. Navigate to the project directory: |
| 68 | +```bash |
| 69 | +cd serial_stream |
| 70 | +``` |
| 71 | + |
| 72 | +3. Install dependencies: |
| 73 | +```bash |
| 74 | +flutter pub get |
| 75 | +``` |
| 76 | + |
| 77 | +4. Run the app: |
| 78 | +```bash |
| 79 | +flutter run |
| 80 | +``` |
6 | 81 |
|
7 | | -This project is a starting point for a Flutter application. |
| 82 | +## Project Structure |
| 83 | +- `lib/` - Main application code |
| 84 | +- `assets/` - Images, and other static files |
| 85 | +- `test/` - Test files |
| 86 | +- Platform-specific directories (android/, ios/, web/, etc.) |
8 | 87 |
|
9 | | -A few resources to get you started if this is your first Flutter project: |
| 88 | +## Contributing |
| 89 | +Feel free to submit issues and enhancement requests. |
10 | 90 |
|
11 | | -- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab) |
12 | | -- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook) |
| 91 | +## License |
| 92 | +This project is licensed under the MIT License - see the LICENSE file for details. |
13 | 93 |
|
14 | | -For help getting started with Flutter development, view the |
15 | | -[online documentation](https://docs.flutter.dev/), which offers tutorials, |
16 | | -samples, guidance on mobile development, and a full API reference. |
| 94 | +## Learn More |
| 95 | +- [Flutter Documentation](https://docs.flutter.dev/) |
| 96 | +- [Dart Documentation](https://dart.dev/guides) |
| 97 | +- [Firebase Documentation](https://firebase.google.com/docs) |
0 commit comments