fda2c2266c | ||
---|---|---|
.circleci | ||
android | ||
assets | ||
ios | ||
lib | ||
preview | ||
test | ||
tool | ||
.gitignore | ||
.metadata | ||
CHANGELOG.md | ||
LICENSE | ||
README.md | ||
pubspec.yaml |
README.md
About
Enjoy podcasts with Tsacdop.
Tsacdop is a podcast player developed with Flutter, a clean, simply beautiful and friendly app, which is also free and open source.
Credit to Flutter team and all involved plugins, especially webfeed and Just_Audio.
The podcast search engine is powered by ListenNotes.
Features
- Podcast group management
- Playlist support
- Sleep timer / speed setting
- OMPL file export and import
- Auto syncing in background
- Listening and subscription history record
- Dark mode / accent color
- Download for offline play
- Auto download new episodes / auto delete outdated downloads
- Settings backup
- Skip silence
- Boost volume
More to come...
Preview
Home Page | Group | Podcast | Episode | Dark Mode |
---|---|---|---|---|
Localization
Please Email me you'd like to contribute to support more languages!
Credit to Localizely for kind support to open source projects.
License
Tsacdop is licensed under the GPL v3.0 license.
Build
- If you don't have Flutter SDK installed, please visit offcial Flutter site.
- Fetch latest sorce code from master branch.
git clone https://github.com/stonega/tsacdop.git
- Add api search api configure file.
Tsacdop uses ListenNotes API 1.0 pro to search for podcasts, which is not free, so I can not expose the API key in the repo.
If you want to build the app, you need to create a new file named .env.dart
in lib folder. Add the following code to .env.dart
.
You can get your own API key on ListenNotes, remember that you need to get pro plan API, because basic plan dosen't provide rss link for serach result. If no api key is added, the search function in the app won't work. But you can still add podcasts by using an RSS link or importing an OMPL file.
final environment = {"apiKey":"APIKEY"};
- Run the app with Android Studio or Visual Studio. Or the command line.
flutter pub get
flutter run
Contribute
If you have an issue or found a bug, please raise a GitHub issue. Pull requests are also welcome.
Archetecture
Plugins
- Local storage
- sqflite
- shared_preferences
- Audio
- just_audio
- audio_service
- State management
- provider
- Download
- flutter_downloader
- Background task
- workmanager
Directory Structure
UI
src
├──home
├──home.dart [Homepage]
├──searc_podcast.dart [Search Page]
└──playlist.dart [Playlist Page]
├──podcasts
├──podcast_manage.dart [Group Page]
└──podcast_detail.dart [Podcast Page]
├──episodes
└──episode_detail.dart [Episode Page]
├──settings
└──setting.dart [Setting Page]
STATE
src
├──state
├──audio_state.dart [Audio State]
├──download_state.dart [Episode Download]
├──podcast_group.dart [Podcast Groups]
├──refresh_podcast.dart [Episode Refresh]
└──setting_state.dart [Setting]
Service
src
├──service
├──api_service.dart [Podcast Search]
└──ompl_builde.dart [OMPL export]
Known Issue
- Playlist is unstable
Contact
You can reach out to me directly at tsacdop.app@gmail.com.
Or you can join our Telegram Group.
Getting Started with Flutter
This project is a starting point for a Flutter application.
Here are a few resources to get you started if this is your first Flutter project:
For help getting started with Flutter, view our online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.