x15904151985/iptvnator
1
0 Fork 0
mirror of https://github.com/4gray/iptvnator.git synced 2026-10-08 09:01:03 -08:00
Code Issues Packages Projects Releases Wiki Activity

chore(github): replace issue templates with issue forms (#1697)

Browse Source 
* 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>

* chore(github): address issue form review feedback

- Playback form: add an "Audio player (radio station)" choice, qualify
  the Embedded MPV/VLC advice as desktop-only with a note on browser
  limits for the self-hosted web app, and fold the last working version
  into the description (12 inputs, the size immich ships).
- Feature form: add the credentials and private URL reminder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(github): narrow the self-hosted CORS note in the playback form

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
4grayandClaude Opus 5.5 authored and GitHub committed 2026-09-27 09:34:30 +02:00
1 parent b40f2c310f
commit 254d1fd922
6 files changed
+359 -55
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

.github/ISSUE_TEMPLATE/---bug-report.md
-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.
.github/ISSUE_TEMPLATE/---feature-request.md
-20
View File
@@ -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.
.github/ISSUE_TEMPLATE/bug_report.yml
+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.
.github/ISSUE_TEMPLATE/config.yml
+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.
.github/ISSUE_TEMPLATE/feature_request.yml
+72
View File
@@ -0,0 +1,72 @@
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
- label: I removed usernames, passwords, MAC addresses, tokens and private URLs from any examples or screenshots I share.
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
.github/ISSUE_TEMPLATE/playback_problem.yml
+150
View File
@@ -0,0 +1,150 @@
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.
- **Desktop app:** 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.
- **Self-hosted web app:** only the browser players are available. HLS, DASH and MPEG-TS streams may fail when the provider doesn't send CORS headers, and the browser may block `http://` streams on an `https://` page. Trying the same stream in the desktop app or in VLC helps us narrow it down.
- 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)
- Audio player (radio station)
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?
description: If it did, please name the last version that worked under **What happened?**.
options:
- Yes, it worked in an earlier version
- No, it never worked for me
- I don't know
validations:
required: true
- type: textarea
id: what-happened
attributes:
label: What happened?
description: |
Describe what you see and when. If it stops, roughly after how long? If it worked before, which version was the last one that worked?
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.