Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Configuring AntennaPod SP
Clone this wiki locally
First of all, please make sure that you have read Building AntennaPod SP and have successfully built the project.
Set the package name
In order to make sure that your app has a unique application ID, edit
build.gradle and search the file for the line that reads
Change the word
custom in this line so that no one else is going to use the same application ID as your app does. Please do NOT change part before the word
custom, otherwise all the other single purpose apps won't be able to recognize your app.
Set the app's name
To change the name of your app, edit the file
res/values/strings.xml and search for the line that reads
Change the value inside this XML-element to the name of your app. Since AntennaPodSP is also available in different languages, there is one
strings.xml file for every language for which you have to repeat this process. At the moment, you have to edit the
strings.xml files in the following folders:
Next, you will have to enter the list of feeds that your app should subscribe to and adjust the preferences of the app if needed.
All of this can be done in a single file called
AppPreferences.java, which you can find in
The configuration file contains a couple of variables, which already have values assigned to them. You have to change at least the variables
feedUrls, which contains the list of feeds that the single purpose app should subscribe to, and
USER_AGENT, which is the name of the user agent that is used when making HTTP-requests (for example when downloading episodes).
All other variables can be changed if needed, but can also be left unchanged.
At the top of the file, you can also find a variable called
feedUrlsVersionNumber. This variable holds the current version number of your configuration. Whenever you change any of the values in AppPreferences after you have released your app, you have to make sure to also increase this variable, so that upgraded installations can recognize that the preferences have changed.
Now that your single purpose app's code is configured, you have to add icons and other graphics for your app. In order to make sure that all your icons have an appropriate resolution, you can use the Android Asset Studio.
Set up the splash screen graphics
The splash screen is shown as soon as your app launches. It consists of one square image in the middle of the screen and has a specific background color.
For generating a splash screen icon in all required resolutions, go to the Generic icons generator of the Android Asset Studio and set the size of the icon to 200 dip. Change the name of the icon to
splash and download the zip-file with the generated icons. Next, move the
splash.png files from the zip-file into the corresponding drawable-folders of the AntennaPodSP project. The drawable-folders of AntennaPodSP can be found in the
res/-folder and are named like this:
After that, edit the file
res/values/colors.xml and search for the line that reads
and change the color value inside the XML-element to the desired value (for example, the background color of your splash screen image).
Add your app icon
Now you need to add a launcher icon for your app. You can generate one with the Launcher icon generator of the Android Asset Studio. This time, you should also click on the
Generate web icon button to generate an additional web icon for Google Play. Again, you will get one icon for each resolution, which you will have to move into the corresponding drawable-folder of AntennaPodSP as it was described in the previous section. Rename
ic_launcher-web.png and use it to replace the
ic_launcher-web.png file in the root-directory of the project.
Modify the app's about-page
Your app will also have an about-page which you will have to modify. It is a simple HTML-file that can be found in
assets/about.html. about.html also references a picture called
logo.png in the same folder, which you can replace with your own picture, for example the
ic_launcher-web.png file from the previous section. The default in
/assets/config_example.json is Einschlafen Podcast