homebridge / homebridge/plugins

Verification Request: homebridge-adhanpod

Open
#1,207 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

awaiting-final-review request-verification
Dominant language
TypeScript
Stars
369
Forks
24
PR merge metrics
No merged PRs in 30d

Description

Plugin Name

homebridge-adhanpod

Link To GitHub Repo

https://github.com/SyButter/homebridge-adhanpod

Plugin Icon (Optional)
Image
The plugin does not offer the same nor less functionality than that of any existing verified plugin.

🟢 Yes

The plugin successfully installs and does not start unless it is configured.

🟢 Yes

The plugin does not require the user to run Homebridge in a TTY or with non-standard startup parameters, even for initial configuration.

🟢 Yes

The plugin does not contain any analytics or calls that enable you to track the user.

🟢 Yes

If the plugin needs to write files to disk (cache, keys, etc.), it stores them inside the Homebridge storage directory.

🟢 Yes

The plugin does not throw unhandled exceptions, the plugin must catch and log its own errors.

🟢 Yes

More Information

This plugin uses pyatv's atvremote CLI (a well-established, actively maintained Apple TV/AirPlay control tool) to stream adhan/dua MP3 files to one or more HomePods simultaneously via AirPlay, calculated using the adhan npm package (supporting the standard calculation methods plus custom Fajr/Isha angles). Users configure which of the five daily prayers to announce, whether to play the after-adhan dua, and can supply their own MP3 recordings via a mediaPath config option.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked homebridge-adhanpod repository and compare its installation, configuration, error handling, storage, analytics, and TTY behavior with the verification checklist. Inspect its use of pyatv's atvremote CLI and the adhan package; done means confirming each requirement and recording any missing evidence or needed changes in this issue.

Written by the indexing model from the issue text.

Assessment

Tech stack
python, typescript
Domain
tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.