- PHP 86.2%
- Blade 12.4%
- JavaScript 0.5%
- CSS 0.5%
- Shell 0.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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 |
||
| app | ||
| bootstrap | ||
| config | ||
| database | ||
| deploy | ||
| lang/en | ||
| public | ||
| resources | ||
| routes | ||
| storage | ||
| tests | ||
| .editorconfig | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| .npmrc | ||
| artisan | ||
| composer.json | ||
| composer.lock | ||
| install.sh | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| phpunit.xml | ||
| README.md | ||
| vite.config.js | ||
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)
/livepage 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.