chore(github): replace issue templates with issue forms

The Markdown bug and feature templates still asked "PWA or
Electron/Tauri application" with 0.16.0 as the example version, and
as free text they were mostly left unfilled: in the September backlog
triage only about a third of bug reports named the version or the
player, and 34 had to be sent back for a retest because they could
not be tied to a fix.

Replace them with GitHub issue forms that make the version, install
method, OS, source type and selected player required fields, ask
whether the problem is a regression, and point to Copy diagnostics.
Add a dedicated form for playback problems, the largest class of
reports, and a config that disables blank issues and links questions
to Discussions, the Docker guide and the website.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
4grayandClaude Opus 5.5 committed 2026-09-26 11:03:28 +02:00
1 parent 3ed612ba65
commit 1b583ce648
6 files changed
+359 -55

No files matched your search

-35
View File
@@ -1,35 +0,0 @@
---
name: "\U0001F41E Bug report"
about: Create a report to help us improve
title: ''
labels: ''
assignees: ''
---
**Describe the bug**
A clear and concise description of what the bug is.
**To Reproduce**
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error
**Expected behavior**
A clear and concise description of what you expected to happen.
**Screenshots**
If applicable, add screenshots to help explain your problem.
**Desktop (please complete the following information):**
- PWA or Electron/Tauri application
- OS: [e.g. Linux]
- Browser [e.g. chrome, safari]
- Version [e.g. 0.16.0]
- Feature: [e.g. M3U playlist, Xtream Code, Stalker Portal]
**Additional context**
Add any other context about the problem here.
@@ -1,20 +0,0 @@
---
name: "\U0001F680 Feature request"
about: Suggest an idea for this project
title: ''
labels: ''
assignees: ''
---
**Is your feature request related to a problem? Please describe.**
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
**Describe the solution you'd like**
A clear and concise description of what you want to happen.
**Describe alternatives you've considered**
A clear and concise description of any alternative solutions or features you've considered.
**Additional context**
Add any other context or screenshots about the feature request here.
+126
View File
@@ -0,0 +1,126 @@
name: 🐞 Bug report
description: Something in IPTVnator doesn't work as expected.
title: '[Bug]: '
labels: ['bug :bug:']
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to report a bug! The details below help us reproduce it on the first try.
- **A channel, movie or episode doesn't play or stops?** The **Playback problem** form asks the right questions for that.
- **A question or an idea?** Please use [Discussions](https://github.com/4gray/iptvnator/discussions) or the **Feature request** form.
- type: checkboxes
id: checks
attributes:
label: Before you submit
options:
- label: I'm on the latest release (or a nightly build) and the problem still happens there.
required: true
- label: I searched the [existing issues](https://github.com/4gray/iptvnator/issues?q=is%3Aissue) and this hasn't been reported yet.
required: true
- label: I removed usernames, passwords, MAC addresses, tokens and private URLs from everything I paste below.
required: true
- type: input
id: version
attributes:
label: IPTVnator version
description: Shown in **Settings → About**. For a nightly build, add the commit shown there too.
placeholder: 0.24.0
validations:
required: true
- type: dropdown
id: install
attributes:
label: How do you run IPTVnator?
options:
- Windows installer (.exe)
- macOS app (.dmg or .zip)
- macOS via Homebrew
- Linux AppImage
- Linux .deb, .rpm or pacman package
- Linux Snap
- Linux Flatpak
- Arch Linux AUR (iptvnator-bin)
- Self-hosted web app (Docker)
- Built from source
validations:
required: true
- type: input
id: os
attributes:
label: Operating system and version
description: For the self-hosted web app, add the browser you use as well.
placeholder: Windows 11 24H2 · macOS 26.6 on Apple Silicon · Ubuntu 24.04 · Docker on Unraid + Firefox
validations:
required: true
- type: dropdown
id: source
attributes:
label: Source type
description: Which kind of source is affected? Pick all that apply.
multiple: true
options:
- M3U playlist added by URL
- M3U playlist added from a file or text
- Xtream Codes
- Stalker portal
- Not related to a source
validations:
required: true
- type: dropdown
id: player
attributes:
label: Video player
description: The player selected in **Settings → Playback → Video player**.
options:
- HTML5 video player
- Video.js player
- ArtPlayer
- Embedded MPV (Experimental)
- Embedded MPV with the frame-copy engine
- MPV player (external)
- VLC (external)
- Not related to playback
validations:
required: true
- type: dropdown
id: regression
attributes:
label: Did this work in an earlier version?
options:
- Yes, it worked in an earlier version
- No, it never worked for me
- I don't know
validations:
required: true
- type: input
id: last-working-version
attributes:
label: Last version where it worked
description: Only if it worked before.
placeholder: 0.23.0
- type: textarea
id: what-happened
attributes:
label: What happened?
description: What did you see, and what did you expect to happen instead?
validations:
required: true
- type: textarea
id: steps
attributes:
label: Steps to reproduce
placeholder: |
1. Open an Xtream Codes playlist
2. Go to Live TV and pick a category
3. …
validations:
required: true
- type: textarea
id: diagnostics
attributes:
label: Diagnostics, logs and screenshots
description: |
If an error screen appears during playback, click **Copy diagnostics** and paste the report here; it contains no stream URLs or credentials.
You can also drag screenshots or a short screen recording into this field.
+11
View File
@@ -0,0 +1,11 @@
blank_issues_enabled: false
contact_links:
- name: 💬 Questions and help
url: https://github.com/4gray/iptvnator/discussions
about: Ask how to set something up, or share ideas with other users.
- name: 🐳 Self-hosting with Docker
url: https://github.com/4gray/iptvnator/blob/master/docker/README.md
about: Setup, environment variables and reverse-proxy notes for the self-hosted web app.
- name: 🌐 Website and downloads
url: https://4gray.github.io/iptvnator/
about: Download links for every platform, FAQ and release announcements.
@@ -0,0 +1,70 @@
name: 🚀 Feature request
description: Suggest a new feature or an improvement.
title: '[Feature]: '
labels: ['enhancement :magic_wand:']
body:
- type: markdown
attributes:
value: |
Thanks for the idea! If a similar request already exists, a 👍 and your use case there help more than a new issue.
- type: checkboxes
id: checks
attributes:
label: Before you submit
options:
- label: I searched the [existing issues](https://github.com/4gray/iptvnator/issues?q=is%3Aissue) and this hasn't been requested yet.
required: true
- type: textarea
id: problem
attributes:
label: What problem would this solve?
description: Describe what you're trying to do and what gets in the way today.
validations:
required: true
- type: textarea
id: solution
attributes:
label: What would you like to happen?
description: How should it work from your point of view? Mockups and examples from other apps are welcome.
validations:
required: true
- type: dropdown
id: area
attributes:
label: Area
multiple: true
options:
- Live TV and programme guide (EPG)
- Movies and series
- Playback and player controls
- Playlists and sources
- Favorites, history and downloads
- Search
- Settings, backup and sync
- Installation, updates and packaging
- Self-hosted web app (Docker)
- Other
- type: dropdown
id: source
attributes:
label: Source types
description: Which sources should this work with?
multiple: true
options:
- M3U playlists
- Xtream Codes
- Stalker portals
- All sources
- type: textarea
id: alternatives
attributes:
label: Alternatives you've considered
description: Workarounds you use today, or other ways to solve the problem.
- type: dropdown
id: contribute
attributes:
label: Would you like to help?
options:
- Yes, I'd like to open a pull request
- I can help test it
- Not right now
+152
View File
@@ -0,0 +1,152 @@
name: ▶️ Playback problem
description: A channel, movie or episode doesn't start, stops, stutters, or has no picture or sound.
title: '[Playback]: '
labels: ['bug :bug:']
body:
- type: markdown
attributes:
value: |
Thanks for reporting a playback problem!
**Quick check first:** the built-in HTML5, Video.js and ArtPlayer players can't decode some codecs, for example HEVC/4K, AC3 or MPEG-2 video. Such streams usually play with **Embedded MPV** or an external **MPV** or **VLC** (**Settings → Playback → Video player**). Whether the stream plays there tells us a lot, so please mention it below.
- type: checkboxes
id: checks
attributes:
label: Before you submit
options:
- label: I'm on the latest release (or a nightly build) and the problem still happens there.
required: true
- label: I searched the [existing issues](https://github.com/4gray/iptvnator/issues?q=is%3Aissue) and this hasn't been reported yet.
required: true
- label: I removed usernames, passwords, MAC addresses, tokens and private URLs from everything I paste below.
required: true
- type: input
id: version
attributes:
label: IPTVnator version
description: Shown in **Settings → About**. For a nightly build, add the commit shown there too.
placeholder: 0.24.0
validations:
required: true
- type: dropdown
id: install
attributes:
label: How do you run IPTVnator?
options:
- Windows installer (.exe)
- macOS app (.dmg or .zip)
- macOS via Homebrew
- Linux AppImage
- Linux .deb, .rpm or pacman package
- Linux Snap
- Linux Flatpak
- Arch Linux AUR (iptvnator-bin)
- Self-hosted web app (Docker)
- Built from source
validations:
required: true
- type: input
id: os
attributes:
label: Operating system and version
description: For the self-hosted web app, add the browser you use as well.
placeholder: Windows 11 24H2 · macOS 26.6 on Apple Silicon · Ubuntu 24.04 · Docker on Unraid + Firefox
validations:
required: true
- type: dropdown
id: source
attributes:
label: Source type
options:
- M3U playlist
- Xtream Codes
- Stalker portal
validations:
required: true
- type: dropdown
id: content
attributes:
label: What were you playing?
options:
- Live TV channel
- Catch-up / archive programme
- Movie
- Series episode
- Radio station
validations:
required: true
- type: dropdown
id: player
attributes:
label: Video player
description: The player selected in **Settings → Playback → Video player**.
options:
- HTML5 video player
- Video.js player
- ArtPlayer
- Embedded MPV (Experimental)
- Embedded MPV with the frame-copy engine
- MPV player (external)
- VLC (external)
validations:
required: true
- type: dropdown
id: symptoms
attributes:
label: What goes wrong?
multiple: true
options:
- It doesn't start or keeps loading
- An error message appears
- It stops after a while
- It stutters or keeps buffering
- No picture, only sound
- No sound, or the wrong audio track
- Subtitles are missing or wrong
- Seeking or resuming goes to the wrong position
- Something else
validations:
required: true
- type: dropdown
id: elsewhere
attributes:
label: Does the same stream play elsewhere?
options:
- Yes, with another player in IPTVnator
- Yes, in VLC or another app outside IPTVnator
- No, it fails everywhere I tried
- I haven't tried
validations:
required: true
- type: dropdown
id: regression
attributes:
label: Did this work in an earlier version?
options:
- Yes, it worked in an earlier version
- No, it never worked for me
- I don't know
validations:
required: true
- type: input
id: last-working-version
attributes:
label: Last version where it worked
description: Only if it worked before.
placeholder: 0.23.0
- type: textarea
id: what-happened
attributes:
label: What happened?
description: |
Describe what you see and when. If it stops, roughly after how long?
Mention the stream format if you know it (HLS .m3u8, MPEG-TS .ts, DASH .mpd, MKV…). Please don't paste full stream URLs that contain credentials or tokens.
validations:
required: true
- type: textarea
id: diagnostics
attributes:
label: Diagnostics, logs and screenshots
description: |
If an error screen appears, click **Copy diagnostics** and paste the report here; it contains no stream URLs or credentials.
If playback starts, the values from **Stream info** in the player overlay help too. Screenshots and short recordings are welcome.