There are millions of potential listeners for your podcast on Bixby. Let's get it into their ears right now! If you've never touched a line of code before, don't worry: this post is here to walk you through it. Read on, or watch the helpful video from our very own Jonathan Pan.
How to create a capsule on Bixby for your podcast
1. Get the tools you need
First things first: find the RSS feed URL for your podcast. Next, you'll need to install the Bixby Developer Studio on your computer; it's got all the tools you need to get your podcast ready for Bixby.
- Log on or create an account on bixbydevelopers.com.
- Download the Bixby Developer Studio for your personal computer.
- Install the Bixby Developer Studio.
- Run the Bixby Developer Studio.
2. Set it up
You're ready to start setting up your podcast Capsule.
- Log into the Bixby Developer Studio.
- In the left-hand column of the Bixby Developer Studio, click Create New Capsule from Template.
The Select a template page opens.
- Click Podcast Template.
- Select a language.
- Paste in your RSS feed URL.
The Capsule info page opens.
- Enter a Capsule ID in the Capsule ID (namespace.capsuleName) field.
For the sake of simplicity, the name of your Capsule should be your podcast's name, too. The name should follow the convention "playground.[your capsule name without spaces]" (ex: playground.bixbydeveloperschat)
- At the bottom of the window, click Generate Capsule.
The Bixby Developer Studio will generate everything you need.
3. Testing, testing
You can test the setup in the Bixby Developer Studio, too.
- On the left-hand side of the Bixby Developer Studio, click the icon that looks like a phone (this is the Simulator icon).
The Bixby Simulator opens.
- Type "play me a podcast" into the Bixby Simulator.
Your podcast should start to play.
- Type "show episodes" into the Bixby Simulator.
The right-hand side of the Bixby Developer Studio should list your podcast's episodes.
4. Enter your metadata
Now it's time to fill in your podcast's metadata; since you already created your podcast sometime before making this Capsule, the requested information should be pretty familiar.
- The left-hand panel of the Bixby Developer Studio looks like a folder tree: open the resources/en folder and click on capsule-info.bxb.
- In the main panel of the Bixby Developer Studio, fill in all of the appropriate metadata.
1. Fill in your developer-name.
2. To upload an icon for your podcast, open the assets/images/icons folder in the folder tree and drag the image file into it.
3. Add a description for your podcast.
4. Enter your podcast's website-url if applicable.
5. If you'd like to add more than one entry in search-keywords, put each additional keyword on its own line.
6. The dispatch-name should match the display-name.
- Test your dispatch-name entry:
1. Make sure your computer's microphone is on.
2. In the Bixby Simulator, click the microphone icon.
3. Say "Start
Your podcast should start to play.
5. Set up your Hints
There are alternate audio prompts you can use to get your podcast to start playing; we call these Hints. You can enter new Hints in another file under resources/en, labeled example-podcast.hints.bxb.
- In the folder tree, open resources/en/example-podcast.hints.bxb.
- The main panel of the Bixby Developer Studio opens.
When you first open this file, it contains example code already set up for you that's been deactivated by the // at the start of each line.
- Delete the // at the start of each line to activate the code.
- Enter some new Hints.
Make sure to put each one on its own line.
We recommend the following three formats for Hints:
[your podcast name], start
[your podcast name]
[your podcast name], show me all episodes
6. Register and submit your Capsule
Now it's time to register and submit your Capsule for inclusion in the Bixby Marketplace:
- Log on to bixbydevelopers.com.
- In the left-hand column, click Teams & Capsules.
- Click Create Team and create your team.
- Click Register Capsule.
The Register Capsule dialog opens.
- In the text field, enter whatever you put after the period (.) when you entered your Capsule ID.
- Click Submit.
The Register Capsule dialog closes; you should now see your podcast listed on the page.
- Click your podcast's name.
At the very top of the page, the Capsule ID is displayed.
- Copy the Capsule ID.
- Go back to the Bixby Developer Studio.
- In the Bixby Developer Studio folder tree, open capsule.bxb.
- Copy the Capsule ID into the ID line under capsule.
- On the left-hand side of the Bixby Developer Studio, click the icon that looks like a cloud with an arrow in it.
The Submission History panel opens.
- In the Submission History panel, click Create New Submission.
The Create New Submission page opens; your podcast should appear here.
- If you want, enter a Description that helps you identify the submission you're making.
For example: "First attempt."
15 Click Submit Capsule.
- Go back to your podcast's page on bixbydevelopers.com.
If you lost your place, you can find your podcast's page by clicking Teams & Capsules in the left-hand column.
- Refresh your podcast's page.
In the Available Versions section, your submission should appear.
- In the Available Versions section, click Submit for Review.
The Publishing Capsule to Marketplace dialog opens.
- If you want, enter any comments you'd like the reviewers to read in the text box.
- Select the I acknowledge... checkbox.
- Click Proceed.
Your podcast has now been submitted for review!