Skip to content

theNatePi/myPod

Repository files navigation

myPod

myPod is a standalone podcast client styled like a 5th Generation iPod Nano!

Features

  • Add any podcast from its RSS link
  • Automatic ingest of episodes
  • Resume where you left off between sessions
  • Indication of new/in progress episodes
  • Caching and interval updates of all content
Video Demo

This app was build for, and only tested on, macOS

Table of Contents

Installation

If you are using macOS on an M-Series device, you can download the demo from the GitHub "Releases"
Otherwise, see the Build From Source section.

Podcasts and RSS

Most podcasts are published through RSS feeds using an open standard to share their content.
You can find more information about podcasts and RSS in this article from Adobe.
To use myPod, you will first need to find the RSS feed of the podcast you want to listen to. Podcastindex.org should have RSS links to most publicly available podcasts, but any source will do.

How To Use

Moving the window

To move the player window, click at the top of the frame (where a window frame would normally appear) and drag the window

Closing the window

Simply press CMD + Q on macOS or ALT + F4 on Windows to quit. The standard window frame and window controls are hidden for a cleaner look.

Navigating the player

You can use arrow keys and Enter to navigate through menu items. To return to the previous screen, press the Menu button on the navigation circle, or press Escape.
You can also click on any of the buttons or items to select them.

Adding a podcast

To add a podcast, navigate to "+ Add Podcast" on the home screen. Paste in an RSS link (see Podcasts and RSS to get one), then press "Add Podcast".

Playing episodes

Once you have added a podcast, select it and choose and episode. To skip around, use the "forward" and "backwards" buttons on the navcircle. The play/pause button is also located in the navcircle. You can also "scrub" to a selected point in the podcast using by hovering over the player bar and clicking/dragging. If you leave an episode and return, the player will resume where you left off.
A blue circle will appear next to any episodes in a podcast which have not been started.
Podcasts will be refreshed once every 24hrs.

Removing podcasts

Not yet implemented

Build From Source

Prerequisites

Before building myPod from source, ensure you have the following installed:

  • Node.js (v18 or higher recommended)
  • npm (comes with Node.js)
  • Build tools for native dependencies (only for building the full app, not required for testing):
    • macOS: Xcode Command Line Tools (xcode-select --install)
    • Linux: build-essential or equivalent
    • Windows: Visual Studio Build Tools or Visual Studio with C++ workload

Installation Steps

  1. Clone the repository

    git clone https://github.com/yourusername/myPod.git
    cd myPod
  2. Install dependencies

    npm install
  3. Development mode To run the app in development mode with hot reload. If you just want to test the app, you can stop here:

    npm run dev
  4. Build for production To build the frontend assets:

    npm run build
  5. Package the application To create distributable packages for your platform:

    npm run make

    This will create platform-specific installers in the out/ directory:

    • macOS: .dmg and .zip files
    • Windows: .exe installer (Squirrel)
    • Linux: .deb and .rpm packages

About

A minimalist standalone podcast client styled after a 5th Generation iPod Nano

Topics

Resources

License

Stars

Watchers

Forks

Contributors