Giter VIP home page Giter VIP logo

antennapod.github.io's Introduction

AntennaPod

This is the official repository of AntennaPod, the easy-to-use, flexible and open-source podcast manager for Android.

Get it on Google Play Get it on F-Droid

Screenshot 0 Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Feedback

You can use the AntennaPod Forum for discussions about the app or just podcasting in general.

Bug reports and feature requests can be submitted here (please read the instructions on how to report a bug and how to submit a feature request first!).

We also hold regular community calls to discuss anything AntennaPod-related. Come join the next call!

Help to test AntennaPod

AntennaPod has many users and we don't want them to run into trouble when we add a new feature. It's important that we have a significant group test our app, so that we know all possible combinations of phones, Android versions and use cases work as expected. Check out our wiki on how to join our Beta testing program! If a bug is reported during the beta period, chances are high that it will be fixed before the stable version. If it is reported later, fixing might take another full beta cycle. So definitely let us know if something is not right.

License

AntennaPod is licensed under the GNU General Public License (GPL-3.0). You can find the license text in the LICENSE file.

Translating AntennaPod

If you want to translate AntennaPod into another language, you can visit the Transifex project page.

Building AntennaPod

You can build AntennaPod just like any other Android project. Refer to the instructions for more details.

antennapod.github.io's People

Contributors

13048 avatar aliervo avatar antennapod-bot avatar anxh3l0 avatar brad avatar bytehamster avatar chk1 avatar cweiske avatar danieloeh avatar dependabot[bot] avatar dwaxe avatar femmdi avatar keunes avatar loucasal avatar matth7878 avatar mfietz avatar nini1294 avatar repat avatar rotzbua avatar schwedenmut avatar shinwookim avatar stevenroose avatar stimmenhotel avatar strypey avatar tomhennen avatar vitaly-zdanevich avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

antennapod.github.io's Issues

List WL translation components in specified order of importance

Can be done in the admin panel of each respective component.
I think priority=100 is the default value.

Short strings, general, documentation, contribute?

https://antennapod.org/contribute/translate

We encourage you to start with the components General and the Short strings, because these will be the first elements a user sees on the website. The component Documentation is a very close second priority, because this section is directly available via the app when people tap on Support. The Contribute component comes last, because a basic understanding of English is needed anyway to interact with the community.

Ruby build depricated

In the build logs I just saw the following:

Run actions/setup-ruby@v1
------------------------
NOTE: This action is deprecated and is no longer maintained.
Please, migrate to https://github.com/ruby/setup-ruby, which is being actively maintained.

Could that be why my recent commits are failing? @ByteHamster

The Documentation does not address recovery from data loss

In reference to my comment on AntennaPod issue 2463

Could the FAQ not address this situation directly as it's potentially catastrophic?

I found myself victim of this bug and was unsure how to proceed in recovering the situation. I thought another section in the FAQ could answer this directly. I propose something below and if it's acceptable I'll put in a PR:


Help! I lost my settings/subscriptions/media/everything!

Subscriptions and metadata can be mostly recovered if you have taken any of the steps from 'How do I keep my data when changing phone?', please see the answer there. However if you have not done that your options are more limited:

  • Attempt to recover the sqlite database. AntennaPod may have written a file CorruptedDatabaseBackup.db to its app storage directory. There are guides online for how to recover a database. If you succeed in repairing it use the "Import Database" feature under Settings-Storage to reload it.
  • You can see the titles of any podcast you recently downloaded in the 'files/media' dir under the app storage dir. From this list you can manually re-add the subscriptions. Any previously downloaded media still present on your device will not be recognised until you re-download an episode. Playback position, history and your queue will remain lost.

What I don't know for sure right now:

  • If it is possible to repair the CorruptedDatabaseBackup.db file how can it be used by AntennaPod again? Use the Import Database function? What is stored in the database exactly? What would be recovered?
  • If you re-subscribe to podcasts previously lost AntennaPod does not seem to register see the old media it previously downloaded in media dir, episodes have to be re-downloaded. However when you do re-download it adds a small (64kb) file e.g. "ORIGINAL-1.mp3" in the media dir and is then able to play the full episode, presumably from the old 'ORIGINAL.mp3' media file. So it seems the best advice is to leave your old media files in place (if any)? Will those old files be cleaned up eventually even if not re-downloaded?
  • Are there any other ways to recover?

Thanks.

Add 'Join community' section

From AntennaPod/AntennaPod#1629

<b>Join the AntennaPod community!</b>
AntennaPod is under active development by volunteers. You can contribute too, with code or with comment!

Ask your question or give feedback via Twitter:
https://twitter.com/@AntennaPod

Share your ideas, favorite podcasting moments and gratitude to all the volunteers in our Google group:
https://groups.google.com/forum/#!forum/antennapod

Help translate the app to your mother tongue on Transifex:
https://www.transifex.com/antennapod/antennapod

Check out our Beta Testing programme to get the latest features first:
https://www.github.com/AntennaPod/AntennaPod/wiki/Help-test-AntennaPod

Visit GitHub to submit feature requests, bug reports and code contributions:
https://www.github.com/AntennaPod/AntennaPod

Add content & code license

Short description: pick & add a license for the website's content & code (aside MIT license of 'theme'), and mention it on the website.

Location: License page

Why have this: so (content & code) contributors know what they're committing to

More info:

Automatically check blog post image requirements

Short description: Automatically check (in GitHub action) main blog post images for their ratio and size.

Location: Blog

Why have this: We want blog images to have a certain ratio, so that the space in the blog overview is used efficiently, and of high enough quality to display nicely on social media.

More info: We can use ImageMagick's identify through GitHub action. Ratio + minimum size to be determined.

Mention in-app ๐Ÿช policy

Short description: Mention that in-app cookies are cleared on every app launch.

Location: Privacy

Why have this: It helps people like me understand that cookies not only affect/are used in websites. And informs concerned people what they can do about in-app cookies.

More info: AntennaPod/AntennaPod#5591

Homepage upgrade

Short description:
Spice up the most prominent page with the following elements

  • #104 Integrate more screenshots in landing page
  • #101 Code contributions graph
  • #100 'Latest forum posts' list
  • #97 Display list of features on homepage

Location:
Homepage

Why have this:
See respective issues

More info:
Mock-up on Penpot

I didn't implement it in the mock-up, but I think we should only display two rows of features by default, and have a 'Show all' button to unhide the other rows.

@ByteHamster What do you think? I indeed opted not to include some of the elements on the homepage I was thinking of first (contributors list, latest version).

Website not rebuilt after bot pushes updated translations

Short description:
When I push translations from Weblate, they end up in the translations branch, and an action automatically pushes them to the main branch (recreates affected files there). However, this update on the main branch (pushed by AntennaPod-bot) do not lead to a website rebuild.

URL: n/a

More info:
Here's an example of a commit that I'd expect to lead to website rebuild: 6940c3c

I'm also not sure why we have/there are two actions: Deploy (main.yml) and pages-build-deployment. I guess the former is one we manually specified, the latter one that comes with the GitHub pages settings. I'm wondering if we would still need the former, though.

@ByteHamster, would you have an idea why our bot's pushes are not picked up?

'Latest forum posts' list

Short description: Display a block with the 5 forum threads most recently updated, with the title, category, and possibly also last activity date (similar to what Discourse displays). Each entry is a link that opens the respective forum thread.

Location: Homepage

Why have this: Show that we have an active community; encourage engagement in that community (so that in the end we have more people helping the project with user support).

More info:

  • With a static site, I imagine we want to get this only when a visitor actually might view it, so we should load this block lazily (only when user scrolls down).
  • It could be similar to what's visible on Discourse itself (though without the number of posts):
    (forum header below only in the screenshot because Firefox included it and I'm too lazy to crop it off)
    afbeelding

Project contributors list

Short description: Show the top x / a random set of x contributors on the homepage, each with profile picture and username (?)

Location: Homepage

Why have this: Give the project human faces; show that it's volunteer-based, and reward contributors with visibility.

More info:

  • I'm not sure whether we should 'sort' contributors based on their number of contributions (which would be tricky, and extra work to come to a fair list), or simply display a random set of contributors. If random, we should probably set some kind of threshold per platform (e.g. 5 PRs or issues on GitHub; trust level 3 on the forum).
  • The list should be pulled automatically from GitHub (the two repos; app & website), Transifex (or whatever translations tool we'll have) and the forum. What would be awesome, is if user matching would be done based on username, as to remove duplicates. If we sort based on contributions, people's effort on different platforms are added up (for them to appear higher on the list).
  • I wonder if we should also add a 'The core team' page, listing manually selected key people. It'd also give room to list past contributors, such as the original creator and previous maintainers.

Add Contribution page for Translate

Short description: Add a new page dedicated to the 'Translate' task

Location: https://antennapod.org/documentation/

Why have this: Because the direct link to Transifex that we currently have doesn't make much for a soft landing of new/potential contributors.

More info:

  • Page contents:
    • That we use Transifex, and links to Transifex support info/tutorial.
    • How the translations process works in general (e.g., how often they get pulled into production).
    • That communication, feedback on source strings and dilemmas are ideally shared discussed on our forum, under the Translations category. (Mention downsides of Transifex, e.g. notifications issue.)
    • What to do if a language coordinator isn't active any-more, or if a suggestion doesn't get accepted (-> chip in on forum).
  • As requested on our forum

Code contributions graph

Short description: A simple graph showing code contributions over time (number of commits per week, over the past 6 months). There should be a call 'Join development' or 'Contribute to AntennaPod' in close proximity.

Location: Homepage, bit further down.

Why have this: Showcase that the project is under active development, and encourage people to contribute, too.

More info:

  • Could look similar to the contributor graph on GitHub:
    afbeelding
  • Another layer could be added, indicating the number of contributors during that period (the number of accounts/people that submitted those commits). Though that might make it a bit too complex.
  • It would be more interesting (than number of contributors) to have another layer in the graph for the number of strings that were translated (where each language counts as one), to consider & display also forms of contributions other than code.

Two different FAQ's

@mfietz I saw you created a new FAQ page, whilst there already is an FAQ in the wiki. i think your work is a bit better in approach towards content and in presentation, but I don't think it's a good idea to keep two FAQ's (it's more work to keep more versions up to date and confusing for users).
So I'm wondering why you started a new FAQ rather than updating the wiki-one.
Do you think there's a way to put your content in the wiki-page and somehow get it to display in a nicer way? (so that there's only one content-source)

Documentation should address deletion policy more clearly

There's no documentation at https://antennapod.org/ which makes it hard to point new users in the right direction. In particular I'm trying to figure out what the expected deletion behaviour is. I often find that if I mark an episode as "Played" it stays in my queue and isnt' downloaded. There are a lot of reasons I might mark something played:

  • this particular episode was already broadcast on the radio
  • I listened to it in the car on someone else's phone
  • it's a re-run
  • It's a terrible episode and I don't want to keep thinking maybe I should listen to it
  • I listened to the end but the closing credits are so long that Antennapod thinks I didn't finish it.

I don't know what is supposed to happen and I can't find documentation to figure out what should happen so I don't know if it's my settings or a bug or a combination. But I would expect that all completed episodes would be treated the same, whether they're completed because they played to the end or because they played halfway and I marked them played. More clear documentation of the default flow and places where changing settings will impact the default flow would help me make the most of Antennapod.

A friend started using Antennapod at my suggestion and they're also confused/frustrated and I'd like to point them to some documentation instead of walking them through what I do and puzzling it out together.

Add (random) language showcase

Short description: A block that showcases one, two or three languages that need translations help. Randomly picked between the languages that have a progression between 50 and 99% (for the App resource).

Location: Homepage

Why have this: Showcase languages that need translations, but aren't in so high need that they're demoralizing, so that the visitor thinks "Ah, let's contribute".

More info: Clicking on the language should open the respective language in a new tab. A 'More info' link should open the new Translate contribute page (#102).

Update setup-ruby action

Short description: The action that builds the website has a job using an action that is no longer maintained.

URL: n/a

More info:

Run actions/setup-ruby@v1

NOTE: This action is deprecated and is no longer maintained.
Please, migrate to https://github.com/ruby/setup-ruby, which is being actively maintained.

Serve social media blog image

Short description: Serve all social media the blog images if available.

Location: Individual blog posts.

Why have this:

More info:

Add page for podcasters on 'funding' links

Short description: A page for podcasters where we explain how they can have their funding links show up in AntennaPod (and where it will show up).

Location: Documentation ยป For podcasters

Why have this: The AntennaPod project stands for an open podcasting system. To ensure its future, podcasters need funding beyond advertising and buy-outs by platforms. With this page we can encourage users to reach out to podcasters, and hopefully increase the uptake of the funding tag and more income for creators.

More info: https://twitter.com/antennapod/status/1476465703481925634

Antennapod blog's RSS feed has invalid <link> url in <channel> level

the RSS feed for antennapod.org Blog posts

 https://antennapod.org/rss.xml

has invalid <link> url in <channel> level

<channel>
<title>AntennaPod Blog</title>
<description>AntennaPod Blog posts</description>
<link>https://antennapod.org/blog/</link>

the link contains an invalid closing / after blog

<link>https://antennapod.org/blog/</link>

if you attempt to go to this link you get an error 404 page not found [imgur]

to be valid it would need to be changed to

<link>https://antennapod.org/blog</link>

Flattr link

#2 Removes the previous link to Flattr the app, as the link was broken:

<a href="http://flattr.com/thing/745609"><i class="fa fa-money"></i></a> -

It is possible to create a link to Daniel Oeh's Flattr thing, but I'd propose to register a new organisation to get AntennaPod in the Software section on Flattr and get collective funding.

Create colour consistency

As noted by @ByteHamster in #21:

Unfortunately, we are currently quite inconsistent about the color. The app needs some updates in that regard, too (different colors in different pages).

Indeed we should, and I can start with correcting the website, but I'd need a hex code. I think we can just go ahead with the shade used in the icon on Google Play. @ByteHamster if you agree, please let me know the hex you used :)

Display 'alternatives' page before redirecting to OpenCollective

Short description: A page to which we can link to from the contribute page (instead of directly linking to OpenCollective), with three options/suggestions: donate to your favourite creator (deeplink to Stats page if viewing from Android), donate time to AntennaPod (link to contribute page), donate money (link to OpenCollective).

Location: antennapod.org/donate

Why have this: We hardly need money, and already have quite a bit. Podcasters probably need it more than we do. Providing a link to the stats screen is probably the best to make it concrete.

More info: For text inspiration, see this tweet. For code inspiration, probably look at subscribe deeplink.

Integrate more screenshots in landing page design

Short description: Add more screenshots, nicely integrated in the landing page design.

Location: Homepage

Why have this: Make page more lively; show that AntennaPod is available for other form factors as well.

More info: Can be similar to Element:
Element website image

Make site ready for integrated translation

Short description:
Make the website ready for integration in a (semi-automated) translation system.

Location:
Site-wide, except the blog (posts & section-specific interface).

Why have this:
Make the project and use of the app more accessible to audiences not comfortable with English.

More info:
List of components (Weblate) / resources (Pontoon):

  • General page texts
  • Contribute page texts
  • Documentation page texts
  • General interface texts

To do list:

  • Split pages' MD files into 3 distinct containers w/in _i18n folder: Contribute, Documentation, General
  • Transform localised navbar.yml (in _data) to single file with translation refs, include ref'ed items in generic _i18n/en.yml file using {t ...} (however, maybe this isn't possible - see jekyll/jekyll#8783) OR add navbar yml to components list
  • Make sure all UI texts in _includes are translatable (added as items to general _i18n/en.yml)
  • Make _includes/nav_languages.html use {% for language in data.languages %} (so we don't have to manually add each language there)
  • Make Documentation localisable (incl images & breadcrumb links)
  • Make date format (on blog landing page) localised
  • Make lang-menu use site.languages array instead of site.data.languages array (though take lang name from this other dataset)
  • List site code changes to do when adding a language
  • Write CI script (GitHub action)

Documentation: Using with TOR/Proxies

Short description:
The proxy dialog is rather complex. For privacy sensitive users, it would be great to have a simple explanation about how to connect via TOR.

Location:

Documentation

Why have this:

More info:

Proxy screen -> SOCKS, "localhost"/"127.0.0.1", Port 9050

Display list of features on homepage ('Why use AntennaPod')

Short description: A feature list that describes what AntennaPod is (project characteristics) and can do (technical functionality). Main features should be visible on the homepage, a full list on a dedicated features page.

Location: Homepage and a dedicated 'Features' page.

Why have this: To showcase to potential new users/contributors that AntennaPod really is a cool product!

More info:

  • 'Features' I think should include both technical features (functionality) and characteristics (e.g. respectful of your privacy)
  • Each feature should be a title, and optionally a graphic or icon. When clicking on it, it should display a short description (1-2 sentences), with a 'more info' link if there's a relevant entry in our documentation.
  • The 'chips' to represent features could be similar to the ones used for blog posts (varying in height).
  • It'd be great if we could create a collection, with one md file per feature.
  • We should be able to indicate a priority, where only the top 7 (?) appear on the homepage.
  • We used to have a feature list on the previous homepage :-)

Adjust permalink approach

Short description: Replace page-level permalink definitions with global 'pretty' permalink.

URL: review all MD files

More info:
Add to _config.yml, move existing permalink definition to documentation collection:

permalink: pretty

#112 (comment)

'Latest release' info

Short description: Have a small block displaying the "Latest release" version name & release date and a "What's new" block displaying that version's 'What's new' info (as visible on Google Play and F-Droid). They should probably be visually connected (or a whole), and be updated automatically (without extra intervention for each new release).

Location: Homepage

Why have this: Show that AntennaPod is in active development; encourage visitors to download the app.

More info:

  • We could either create a dynamic section or maybe (don't know if this is possible) from the app's (GitHub) Actions set something in motion that updates the static website?
  • The 'What's new' section could either display the text capped, with a 'read more' button that expands the block (if this whole thing is presented further down on the page, where it can take more space), or just display the version & date with a 'View what's new' button/link (if this whole thing is displayed prominently above the fold, where we want to keep the view clean).
  • displaying the latest release version (date + version number) and a 'what's new' block

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.