Skip to content
This repository was archived by the owner on Feb 1, 2025. It is now read-only.

README, short and full description reworked #92

Open
comradekingu wants to merge 6 commits into
base: master
Choose a base branch
from
Open

README, short and full description reworked #92

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
4fc3eaa
Full description reworked
comradekingu Nov 15, 2021
4d41e7b
Short description reworked
comradekingu Nov 15, 2021
458752c
Small refinements
comradekingu Nov 15, 2021
cea6f7b
README reworked
comradekingu Nov 15, 2021
9560acf
Small refinements
comradekingu Nov 15, 2021
3e232ad
Consistent URLs
comradekingu Nov 15, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 19 additions & 43 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,53 +1,29 @@
README
======

# Escapepod - Podcast Player for Android
<img src="https://raw.githubusercontent.com/y20k/escapepod/master/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png" width="192" />

**Version 1.0.x ("Sag Alles Ab")**

Escapepod is a simple and lightweight app with a minimalistic approach for listening to podcasts, which may not be to everyone's liking. The app has only a single screen. Playback controls and a list of podcasts that shows the five most recent episodes each. Escapepod has no podcast discovery feature. It only offers a very simple search option and it opens RSS podcasts links when you tap them in a web browser.

Escapepod is free and open source. It is published under the [MIT open source license](https://opensource.org/licenses/MIT). Want to help? Please check out the notes in [CONTRIBUTE.md](https://github.com/y20k/escapepod/blob/master/CONTRIBUTE.md) first.

## Install Escapepod
You can install Escapepod via F-Froid and Google Play - or you can go and grab the latest APK on [GitHub](https://github.com/y20k/escapepod/releases).
# Escapepod <img src="https://raw.githubusercontent.com/y20k/escapepod/master/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png" width="192" />
*A minimal non-video Android podcast player*

**Version 1.0.x ("Sag Alles Ab")** \
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/packages/org.y20k.escapepod/)
[<img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png" alt="Get it on Google Play" height="80">](https://play.google.com/store/apps/details?id=org.y20k.escapepod) \
Or get the [GitHub APK](https://github.com/y20k/escapepod/releases).

[<img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png" alt="Get it on Google Play" height="80">](https://play.google.com/store/apps/details?id=org.y20k.escapepod)

## Frequent Questions

### Does Escapepod have playback queue?
Escapepod has a simple up-next feature. Tap play on an episode while listening to another one. You will be be given the opportunity add it to the up-next slot.

### What are the default settings?
- Auto-update does not download files over cellular network
- Escapepod by default only keeps two episodes

### Escapepod keeps more than two episodes.
Escapepod tries to reduce the number of episodes it keeps. Here are the rules for that:

- Escapepod keeps the latest two episodes
- Episodes, that have been started, or that have been downloaded manually, are kept, too
- the maximum number of episodes available (and kept) is five

### Does Escapepod support OMPL?
You can import a podcast list using the [OPML](https://en.wikipedia.org/wiki/OPML) exchange format using the respective option in the app's Settings. The current podcast collection can be exported via Settings, too. Additionally Escapepod keeps an up-to-date OPML file in the folder `/Android/data/org.y20k.escapepod/files/collection/`.

### I cannot add podcast X.
Please report any podcast feeds, that are currently not working, using the GitHub Issue template [Feed Issue](https://github.com/y20k/escapepod/issues/new?assignees=&labels=feed+issue&template=feed-issue.md&title=%5BFeed%5D). Note: Escapepod does not support video podcasts.

### Where do the podcast search results come from?
Escapepod searches by default the [Podcastindex.org](https://podcastindex.org/) online database or, if you toggle the respective setting, the [gpodder.net](https://gpodder.net/directory/) online database.


## Screenshots (v0.8)
[<img src="https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/01-lockscreen-active-v0.8-oneplus5.png" width="240">](https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/01-lockscreen-active-v0.8-oneplus5.png)
[<img src="https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/02-playback-v0.8-oneplus5.png" width="240">](https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/02-playback-v0.8-oneplus5.png)
[<img src="https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/03-large-player-sheet-v0.8-oneplus5.png" width="240">](https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/03-large-player-sheet-v0.8-oneplus5.png)

[<img src="https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/04-show_notes-v0.8-oneplus5.png" width="240">](https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/04-show_notes-v0.8-oneplus5.png)
[<img src="https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/05-podcast-details-v0.8-oneplus5.png" width="240">](https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/05-podcast-details-v0.8-oneplus5.png)
[<img src="https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/06-add-podcast-v0.8-oneplus5.png" width="240">](https://raw.githubusercontent.com/y20k/escapepod/master/metadata/en-US/phoneScreenshots/06-add-podcast-v0.8-oneplus5.png)

One screen shows playback controls and the five most recent episodes of added podcasts. \
A simple search feature using https://podcastindex.org or optionally https://gpodder.net/directory is the only way of discovery. \
Tapping RSS podcast links in a web browser also works. \
Add something to the "Up-next" playlist/playback queue by tapping "Play" on an episode while listening to another. \
Up to five episodes are kept if manually downloaded or started, and always the two most recent ones. \
It is possible to also download over cellular network if turned on in the app. \
Import (or export) a podcasts in the OPML format from the app settings. \
All subscriptions are in /Android/data/org.y20k.escapepod/files/collection/collection_opml.xml

[Translate Escapepod on Hosted Weblate](https://hosted.weblate.org/engage/escapepod/). \
[![Translation status](https://hosted.weblate.org/widgets/escapepod/-/multi-auto.svg)](https://hosted.weblate.org/engage/escapepod/?utm_source=widget)

Escapepod is libre software, licensed [MIT](https://opensource.org/licenses/MIT). All help appreciated.
36 changes: 10 additions & 26 deletions metadata/en-US/full_description.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,26 +1,10 @@
Escapepod is a podcast player with a minimalistic approach, that may not be to everyone's liking. The app has only a single screen. Playback controls and a list of podcasts that shows the five most recent episodes each. Escapepod has no podcast discovery feature. It only offers a very simple search option and it opens RSS podcasts links when you tap them in a web browser.


FREQUENT QUESTIONS

DOES ESCAPEPOD HAVE PLAYBACK QUEUE?
Escapepod has a simple up-next feature. Tap play on an episode while listening to another one. You will be be given the opportunity add it to the up-next slot.

WHAT ARE THE DEFAULT SETTINGS?
- Auto-update does not download files over cellular network
- Escapepod by default only keeps two episodes

CAN ESCAPEPOD KEEPS MORE THAN TWO EPISODES?
Escapepod tries to reduce the number of episodes it keeps. Here are the rules for that:
- Escapepod keeps the latest two episodes
- Episodes, that have been started, or that have been downloaded manually, are kept, too
- The maximum number of episodes available (and kept) is five

DOES ESCAPEPOD SUPPORT OPML?
You can import a podcast list using the OPML exchange format using the respective option in the app's Settings. The current podcast collection can be exported via Settings, too. Additionally Escapepod keeps an up-to-date OPML file in the folder /Android/data/org.y20k.escapepod/files/collection/.

I CAN NOT ADD PODCAST X. WHY?
Please report any podcast feeds, that are currently not working, using the GitHub Issue template "Feed Issue" (https://github.com/y20k/escapepod/issues/). Note: Escapepod does not support video podcasts.

WHERE DO THE PODCAST SEARCH RESULTS COME FROM?
Escapepod searches by default the Podcastindex.org (https://podcastindex.org/) online database - or if you toggle the respective setting the gpodder.net (https://gpodder.net/directory/) online database.
One screen shows playback controls and the five most recent episodes of added podcasts.
A simple search feature from podcastindex.org or optionally gpodder.net/directory is the only way of discovery.
Tapping RSS podcast links in a web browser also works.
Add something to the "Up-next" playlist/playback queue by tapping "Play" on an episode while listening to another.
Up to five episodes are kept if manually downloaded or started, and always the two most recent ones.
It is possible to also download over cellular network if turned on in the app.
Import (or export) a podcasts in the OPML format from the app settings.
All subscriptions are in /Android/data/org.y20k.escapepod/files/collection/collection_opml.xml

Report problems with podcasts or this libre app using https://github.com/y20k/escapepod/issues
2 changes: 1 addition & 1 deletion metadata/en-US/short_description.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1 +1 @@
Escapepod is a simple and lightweight app for listening to podcasts.
Minimal non-video podcast player.