kasts/README.md

# Kasts

Kasts is a convergent podcast application.

<a href='https://flathub.org/apps/details/org.kde.kasts'><img width='190px' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-i-en.png'/></a>

# Get it

Nightly Android APKs are available at [KDE's Binary Factory](https://binary-factory.kde.org/view/Android/job/Kasts_Nightly_android-arm64/).

# Bug reports

Please don't use gitlab issues for reporting bugs, instead report them [here](https://bugs.kde.org/enter_bug.cgi?format=guided&product=kasts).

# Building

Note: When using versions of Kasts built from git-master, it's possible that the database format or the name of downloaded files change from one version to another without the necessary migrations to handle it. If you notice bugs after upgrading to a git-master version, export your feeds, delete `~/.local/share/KDE/kasts` and import the feeds again.

## Requirements
 - KCoreAddons
 - KI18n
 - KConfig
 - Kirigami
 - Syndication
 - TagLib
 - QtKeychain
 - ThreadWeaver

### On debian

```
 apt install build-essential cmake extra-cmake-modules qtbase5-dev \
    qtdeclarative5-dev qtquickcontrols2-5-dev qtmultimedia5-dev \
    libkf5syndication-dev libkf5config-dev libkf5i18n-dev \
    libkf5coreaddons-dev libtag1-dev qtkeychain-qt5-dev \
    libkf5networkmanagerqt-dev libkf5threadweaver-dev
```

## Linux

```
git clone https://invent.kde.org/plasma-mobile/kasts
cd kasts
mkdir build && cd build
cmake .. -DCMAKE_PREFIX_PATH=/usr
make
sudo make install
```

This assumes all dependencies are installed. If your distribution does not provide
them, you can use [kdesrc-build](https://kdesrc-build.kde.org/) to build all of them.

## Android

You can build Kasts for Android using KDE's [Docker-based build environment](https://community.kde.org/Android/Environment_via_Container).
Renaming alligator to kasts everywhere 2021-05-03 22:16:19 +02:00			`# Kasts`
Initial Commit 2020-02-28 23:25:08 +01:00
Renaming alligator to kasts everywhere 2021-05-03 22:16:19 +02:00			`Kasts is a convergent podcast application.`
Update README.md 2020-04-23 14:03:25 +02:00
Add flathub badge 2021-06-20 17:00:59 +02:00			`<a href='https://flathub.org/apps/details/org.kde.kasts'><img width='190px' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-i-en.png'/></a>`

Add link to Binary Factory 2020-04-27 01:08:01 +02:00			`# Get it`

Update links to Android version 2021-09-14 16:16:44 +02:00			`Nightly Android APKs are available at [KDE's Binary Factory](https://binary-factory.kde.org/view/Android/job/Kasts_Nightly_android-arm64/).`
Add link to Binary Factory 2020-04-27 01:08:01 +02:00
Add bug reporting link to README 2022-10-31 10:11:26 +01:00			`# Bug reports`

			`Please don't use gitlab issues for reporting bugs, instead report them [here](https://bugs.kde.org/enter_bug.cgi?format=guided&product=kasts).`

Update README.md 2020-04-23 14:03:25 +02:00			`# Building`

Fix small typos in readme 2022-08-31 17:10:31 +02:00			Note: When using versions of Kasts built from git-master, it's possible that the database format or the name of downloaded files change from one version to another without the necessary migrations to handle it. If you notice bugs after upgrading to a git-master version, export your feeds, delete `~/.local/share/KDE/kasts` and import the feeds again.
Update README.md 2020-09-17 20:55:34 +02:00
Update README.md 2020-04-23 14:03:25 +02:00			`## Requirements`
			`- KCoreAddons`
			`- KI18n`
			`- KConfig`
			`- Kirigami`
			`- Syndication`
Implement loading chapters from mpeg files 2021-10-05 21:34:19 +02:00			`- TagLib`
Add podcast subscription and episode play state synchronization This implements the gpodder API from scratch. It turned out that libmygpo-qt has several critical bugs, and there's no response to pull requests upstream. So using that library was not an option. The implementation into kasts consists of the following: - Can sync with gpodder.net or with a nextcloud server that has the nextcloud-gpodder app installed. (This app is mostly API compatible with gpodder.) - Passwords are stored using qtkeychain. If the keychain is unavailable it will fallback to file. - It syncs podcast subscriptions and episode play positions, including marking episodes as played. Episodes that have a non-zero play position will be added to the queue automatically. - It will check for a metered connection before syncing. This is coupled to the allowMeteredFeedUpdates setting. - Full synchronization can be performed either manually (from the settings page) or through automatic triggers: on startup and/or on feed refresh. - There is an additional possibility to trigger quick upload-only syncs to make sure that the local changes are immediately uploaded to the server (if the connection allows). This will trigger when subscriptions are added or removed, when the pause/play button is toggled or an episode is marked as played. - This implements a few safeguards to avoid having multiple feed URLS pointing to the same underlying feed (e.g. http vs https). This solves part of #17 Solves #13 2021-10-29 17:00:52 +02:00			`- QtKeychain`
Use multithreading for feed updates (using ThreadWeaver) This contains the following changes: - Use separate db connections for feed updates (required for multithreading. - Add ThreadWeaver dependency. - Port update job from KJob to ThreadWeaver::Job - This should also solve the bug where the update process would hang on the "processEvents" call, which was intended to keep the UI responsive during updates. BUG: 452585 2022-05-24 13:43:13 +02:00			`- ThreadWeaver`
Update README.md 2020-04-23 14:03:25 +02:00
List the package names on debian This allows easier installation, without having to manually track down all the names of the needed packages. 2022-03-15 12:47:23 +01:00			`### On debian`

			```
			`apt install build-essential cmake extra-cmake-modules qtbase5-dev \`
			`qtdeclarative5-dev qtquickcontrols2-5-dev qtmultimedia5-dev \`
			`libkf5syndication-dev libkf5config-dev libkf5i18n-dev \`
			`libkf5coreaddons-dev libtag1-dev qtkeychain-qt5-dev \`
Use multithreading for feed updates (using ThreadWeaver) This contains the following changes: - Use separate db connections for feed updates (required for multithreading. - Add ThreadWeaver dependency. - Port update job from KJob to ThreadWeaver::Job - This should also solve the bug where the update process would hang on the "processEvents" call, which was intended to keep the UI responsive during updates. BUG: 452585 2022-05-24 13:43:13 +02:00			`libkf5networkmanagerqt-dev libkf5threadweaver-dev`
List the package names on debian This allows easier installation, without having to manually track down all the names of the needed packages. 2022-03-15 12:47:23 +01:00			```

Update README.md 2020-04-23 14:03:25 +02:00			`## Linux`

Use single code-block 2020-04-23 14:43:50 +02:00			```
Renaming alligator to kasts everywhere 2021-05-03 22:16:19 +02:00			`git clone https://invent.kde.org/plasma-mobile/kasts`
			`cd kasts`
Fix small typos in readme 2022-08-31 17:10:31 +02:00			`mkdir build && cd build`
Use single code-block 2020-04-23 14:43:50 +02:00			`cmake .. -DCMAKE_PREFIX_PATH=/usr`
			`make`
			`sudo make install`
			```
Update README.md 2020-04-23 14:03:25 +02:00
			`This assumes all dependencies are installed. If your distribution does not provide`
			`them, you can use [kdesrc-build](https://kdesrc-build.kde.org/) to build all of them.`

Renaming alligator to kasts everywhere 2021-05-03 22:16:19 +02:00			`## Android`
Update README.md 2020-04-23 14:03:25 +02:00
Renaming alligator to kasts everywhere 2021-05-03 22:16:19 +02:00			`You can build Kasts for Android using KDE's [Docker-based build environment](https://community.kde.org/Android/Environment_via_Container).`
Initial Commit 2020-02-28 23:25:08 +01:00