Podscope podcast CMS https://podscope.cc
  • PHP 86.2%
  • Blade 12.4%
  • JavaScript 0.5%
  • CSS 0.5%
  • Shell 0.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
gdadkisson 4de1ae27e1 v1.14: show lists start empty, so Create show saves first time
Create show opened with one blank row in each of funding links, people
and TXT records (Filament's Repeater default), and those rows have
required fields, so Save failed until each was deleted by hand. Adding a
person did the same with a blank social link, on the show form and on
Settings. All five repeaters now use defaultItems(0), as the episode
form always has. RepeatersStartEmptyTest pins it (fails without the fix).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Nfjt4jBAETZF3fd4DokKzG
2026-11-17 08:57:09 -05:00
app v1.14: show lists start empty, so Create show saves first time 2026-11-17 08:57:09 -05:00
bootstrap v0.90 -- per-show newsletters (double opt-in, Mailgun, public archive) 2026-07-31 11:58:52 -04:00
config v1.14: show lists start empty, so Create show saves first time 2026-11-17 08:57:09 -05:00
database v1.11 -- Saved Notes: a bookmarklet that collects links into show notes 2026-11-14 09:50:54 -05:00
deploy Make the public repo installable and stop publishing production details 2026-10-01 16:38:16 -04:00
lang/en v1.10 -- a failed upload says what to do, not an internal field path 2026-10-28 07:37:11 -04:00
public v1.07 -- security: upgrade Filament, Livewire, Guzzle and commonmark past open advisories 2026-09-25 21:45:00 -04:00
resources v1.12: Save to Podscope pop-up fits the whole form 2026-11-14 10:51:56 -05:00
routes v1.01 -- transcripts keep their disk on a second save, and the old upload endpoint is gone 2026-09-20 17:27:53 -04:00
storage Initial public release -- v0.1 2026-05-21 18:53:00 +00:00
tests v1.14: show lists start empty, so Create show saves first time 2026-11-17 08:57:09 -05:00
.editorconfig Initial public release -- v0.1 2026-05-21 18:53:00 +00:00
.env.example Make the public repo installable and stop publishing production details 2026-10-01 16:38:16 -04:00
.gitattributes Initial public release -- v0.1 2026-05-21 18:53:00 +00:00
.gitignore Make the public repo installable and stop publishing production details 2026-10-01 16:38:16 -04:00
.npmrc Initial public release -- v0.1 2026-05-21 18:53:00 +00:00
artisan Initial public release -- v0.1 2026-05-21 18:53:00 +00:00
composer.json Make the public repo installable and stop publishing production details 2026-10-01 16:38:16 -04:00
composer.lock Make the public repo installable and stop publishing production details 2026-10-01 16:38:16 -04:00
install.sh Make the public repo installable and stop publishing production details 2026-10-01 16:38:16 -04:00
LICENSE Add AGPL-3.0 license 2026-06-09 19:12:09 +00:00
package-lock.json Initial public release -- v0.1 2026-05-21 18:53:00 +00:00
package.json Initial public release -- v0.1 2026-05-21 18:53:00 +00:00
phpunit.xml v0.97 -- membership price changes: timed grandfathering 2026-09-11 13:10:37 -04:00
README.md Make the public repo installable and stop publishing production details 2026-10-01 16:38:16 -04:00
vite.config.js v1.00 -- Themes: one for the site, and one per show if you want it 2026-09-20 16:36:36 -04:00

Podscope

A self-hosted podcast CMS and membership platform. Publish shows, manage episodes, accept paid memberships via Stripe, and distribute private RSS feeds to subscribers.

Features

  • Multi-show support
  • Episode management with Podcasting 2.0 metadata (persons, transcripts, chapters, soundbites)
  • Paid membership plans per show or site-wide (via Stripe / Laravel Cashier)
  • Private RSS feeds for subscribers
  • Free preview window for paid episodes
  • Episode play tracking and stats
  • Individual episode purchases
  • Public RSS feeds with OP3 tracking support
  • Themes for the public site, and a per-show theme that follows a show onto its episodes and its newsletter (presets, brand/accent colours, self-hosted fonts, logo, social image)
  • /live page embedding an Owncast stream, with an automatic on-air banner
  • Filament admin panel
  • Backblaze B2 storage support
  • Redis queue support
  • Alpine.js frontend

Requirements

  • PHP 8.3+ (8.4 recommended)
  • PostgreSQL 14+
  • Redis
  • Node.js 20+ (for asset compilation)
  • Composer
  • A Stripe account (for memberships and purchases)
  • A Backblaze B2 bucket (optional, for media storage)

Quick Install

git clone https://git.knowthenerds.com/Inceptum/podscope.git podscope-installer
bash podscope-installer/install.sh

The installer clones a fresh copy into ./podscope, installs PHP dependencies and creates .env, then prints the remaining steps (the same as Manual Install below). Read it before running it.

Manual Install

git clone https://git.knowthenerds.com/Inceptum/podscope.git
cd podscope
composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate
# Edit .env with your database, Stripe, and storage credentials
php artisan migrate --force
php artisan db:seed --class=RolesAndSettingsSeeder --force   # roles + default settings
php artisan storage:link
npm ci --ignore-scripts && npm run build
php artisan route:cache
php artisan view:cache

Never run php artisan config:cache: Podscope applies its settings from the database at runtime, and a cached config silently ignores them.

Create the first admin, then give it the super_admin role (the admin panel only admits staff roles, and registration gives new accounts the subscriber role):

php artisan make:filament-user
php artisan tinker --execute="App\Models\User::where('email', '[email protected]')->firstOrFail()->assignRole('super_admin');"

Then configure your web server to point at the public/ directory and set up a queue worker:

php artisan queue:work --sleep=3 --tries=3

Configuration

All site settings (name, artwork, RSS options) are managed in the Filament admin panel under Settings.

Key .env values:

Variable Description
APP_URL Your site URL (e.g. https://example.com)
DB_CONNECTION Set to pgsql
DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD PostgreSQL credentials
STRIPE_KEY, STRIPE_SECRET, STRIPE_WEBHOOK_SECRET Stripe API keys
FILESYSTEM_DISK public for local storage or b2 for Backblaze
AWS_* / B2_* Backblaze B2 credentials if using cloud storage
REDIS_HOST Redis connection
MAIL_* Mail settings for transactional email

License

Podscope is free software under the GNU Affero General Public License v3.0 or later (see LICENSE). If you run a modified copy as a public website, the AGPL asks you to offer your changes to its users.