Skip to content

Commit 188ba82

Browse files
committed
Added documentation
1 parent 2b28584 commit 188ba82

23 files changed

+103
-14
lines changed
+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
name: Build mdBook
2+
on:
3+
push:
4+
#branches:
5+
# - main
6+
7+
jobs:
8+
build:
9+
runs-on: ubuntu-latest
10+
steps:
11+
- uses: actions/checkout@v2
12+
- name: Install mdBook
13+
uses: peaceiris/actions-mdbook@v1
14+
- name: Build mdBook
15+
run: mdbook build
16+
working-directory: docs
17+
- name: Deploy to GitHub Pages
18+
uses: peaceiris/actions-gh-pages@v3
19+
with:
20+
github_token: ${{ secrets.GITHUB_TOKEN }}
21+
publish_dir: ./docs/book

docs/.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
book

docs/book.toml

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
[book]
2+
authors = ["SamTV12345"]
3+
language = "en"
4+
multilingual = false
5+
src = "src"
6+
title = "PodFetch Documentation"

docs/build.manifest

-6
This file was deleted.
File renamed without changes.
File renamed without changes.

docs/HOSTING.md renamed to docs/src/HOSTING.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -24,5 +24,5 @@ To enable it you need to set the following variables:
2424

2525
You can acquire the Telegram Bot chat id with the following steps:
2626
1. Write a message to the bot
27-
2. Open the following url in your browser: https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/getUpdates
27+
2. Open the following url in your browser: [Telegram API page](https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/getUpdates)
2828
3. Search for the chat id in the response

docs/src/Installation.md

+46
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Installation
2+
3+
## Installation with Docker
4+
5+
## Installation with Docker (SQLite)
6+
7+
```yaml
8+
version: '3'
9+
services:
10+
podfetch:
11+
image: samuel19982/podfetch:latest
12+
user: ${UID:-1000}:${GID:-1000}
13+
ports:
14+
- "80:8000"
15+
volumes:
16+
- podfetch-podcasts:/app/podcasts
17+
- podfetch-db:/app/db
18+
environment:
19+
- POLLING_INTERVAL=60
20+
- SERVER_URL=http://localhost:80
21+
- DATABASE_URL=sqlite:///app/db/podcast.db
22+
23+
volumes:
24+
podfetch-podcasts:
25+
podfetch-db:
26+
```
27+
28+
It is important to change `UID` and `GID` to your user id and group id so that the files are owned by you and not by root.
29+
Docker will create the volumes by default as root and podfetch will not be able to write to them.
30+
31+
## Installation with Docker (Postgres)
32+
33+
To use postgres you need to set the following environment variables:
34+
35+
```yaml
36+
- DATABASE_URL=postgres://postgres:postgres@postgres:5432/podfetch
37+
```
38+
39+
40+
## Installation without Docker
41+
42+
### Requirements
43+
- Download the latest release from the [release page](https://github.com/SamTV12345/PodFetch/releases)
44+
- Create a shell script that sets the above environment variables and starts the podfetch binary
45+
- Make the shell script executable
46+
- Run the shell script

docs/src/Introduction.md

+14
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Introduction
2+
3+
PodFetch is a simple, lightweight, fast, and efficient podcast downloader for hosting your own podcasts.
4+
It supports all the features you would expect from a podcast player, including:
5+
- Downloading podcasts
6+
- Listening to podcasts
7+
- Searching for podcasts
8+
- Managing your subscriptions
9+
- Managing your podcast episodes
10+
- Managing your podcast feed
11+
- Host your own Gpodder compatible podcast feed
12+
- Start listening on your phone and continue on your computer
13+
14+
All you need to do is download the latest release from the release page or use the listed docker-compose file to get started.

docs/src/SUMMARY.md

+7
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Summary
2+
3+
- [Introduction](./Introduction.md)
4+
- [Installation](./Installation.md)
5+
- [Authorization](./AUTH.md)
6+
- [UI Walkthrough](./UIWalkthrough.md)
7+
- [Hosting](./HOSTING.md)

docs/UIWalkthrough.md renamed to docs/src/UIWalkthrough.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -9,32 +9,32 @@ The podcast listening tool contains an advanced audio player that can be used to
99
The tool will automatically save your progress in the current episode and will resume from where you left off even if you close the browser.
1010
You can continue listening on all devices by just hitting play on any episode on your home screen.
1111

12-
![Continue listening to episodes](./continue_listening.png)
12+
![Continue listening to episodes](./images/continue_listening.png)
1313

1414
## Search for podcasts
1515
You can search for podcast episodes by hitting CTRL+F and typing any word that might appear in the description or title of the podcast episode you want to listen to.
16-
![Audio Player](./search.png)
16+
![Audio Player](./images/search.png)
1717

1818

1919
Below are some fullscreen images so you can get a better grasp of the UI.
2020

2121
## Home Screen
22-
![Home Screen](./home.png)
22+
![Home Screen](./images/home.png)
2323

2424

2525
## Timeline View
2626

27-
![Timeline](timeline.png)
27+
![Timeline](./images/timeline.png)
2828

2929
## Info View
3030

31-
![Info page](Info_Page.png)
31+
![Info page](./images/Info_Page.png)
3232

3333

3434
## Settings
3535

36-
![Settings](settings.png)
36+
![Settings](./images/settings.png)
3737

3838
## Administration
3939

40-
![Administration](administration.png)
40+
![Administration](./images/administration.png)
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)