Files
oki-podcast-reader/README.md
T

72 lines
2.8 KiB
Markdown
Raw Normal View History

2023-02-21 22:42:51 +00:00
# Svelte Podcast
2023-02-21 22:09:10 +00:00
2023-02-21 22:42:51 +00:00
A collection of tools for building podcast websites and tools with Svelte or SvelteKit.
2023-02-21 22:09:10 +00:00
2023-02-21 22:42:51 +00:00
| Version | License | Status |
| :-------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------: |
| [![npm](https://img.shields.io/npm/v/svelte-podcast)](https://www.npmjs.com/package/svelte-podcast) | [![npm](https://img.shields.io/npm/l/svelte-podcast)](https://www.npmjs.com/package/svelte-podcast) | ![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/olliejt/svelte-podcast/publish.yml) |
2023-02-21 22:09:10 +00:00
2023-02-24 21:02:00 +00:00
## What's inside?
2023-07-09 23:21:21 +01:00
- 🔊 Load and play audio files via URL or local files
- 🔃 Navigate via client-side routing while audio continues to play
- 🎛️ Simpler control over audio playback:
- Seek to a specific time
- skip forward ﹢ backward
- play ﹢ pause
- mute ﹢ unmute
- 🛟 Save and load a users progress for each episode in localStorage
- 💾 Save and load a users preferences (like playback speed) in localStorage
- ﹢ volume
- ﹢ playback speed
- 🖼️ Inject episode metadata into the audio store for ea
2023-02-24 21:02:00 +00:00
**Roadmap**
In no particular order, here are some of the things I'm confident will be added to this library:
2023-07-09 23:21:21 +01:00
- ☐ Podcast player component utilities
- ☐ Pre-built player component
- ☐ RSS Feed parsing
- ☐ Looping segments of an episode
- [And more ideas being discussed](https://github.com/OllieJT/svelte-podcast/labels/feature)
2023-02-24 21:02:00 +00:00
2023-02-21 22:42:51 +00:00
## Docs
2023-02-21 22:09:10 +00:00
2023-02-24 21:02:00 +00:00
> **Warning**
> This project is in early development. The docs are not yet complete and the API is likely to change before 1.0.0.
#### Install
```bash
# with npm
2023-07-09 22:18:06 +01:00
npm install svelte-podcast@latest
2023-02-24 21:02:00 +00:00
# with yarn
2023-07-09 22:18:06 +01:00
yarn add svelte-podcast@latest
2023-02-24 21:02:00 +00:00
# with pnpm
2023-07-09 22:18:06 +01:00
pnpm add svelte-podcast@latest
2023-02-24 21:02:00 +00:00
```
You must add one instance of the `<AudioLoader />` to your app. This should be places as high as possible, ideally in your root `+layout,svelte` file.
```html
<script>
import { AudioLoader } from 'svelte-podcast';
</script>
<AudioLoader />
<slot />
```
#### Basic usage
2023-07-09 22:18:06 +01:00
You can find docs and guides for getting started on [svelte-podcast-docs.vercel.app](https://svelte-podcast-docs.vercel.app/)
2023-02-21 22:09:10 +00:00
2023-02-24 21:02:00 +00:00
> **Warning**
2023-07-09 22:18:06 +01:00
> This project is early in development. API changes are likely until we reach v1.0.0.
> **Info**
> Contributions are welcome but I do not plan to provide guides for contributing until the project is more stable.