
Setup Masjidbox Player for Mosque Displays
Setting up your Masjidbox Player takes about 5 minutes. Connect the HDMI cable to your TV, plug in power, link your device via PIN code in the Masjidbox dashboard, and you're ready to display prayer times, announcements, and events. WiFi is optional—Ethernet is recommended for initial setup. Once linked, configure your content in the dashboard and you can manage multiple screens across your mosque.
What You'll Need Before Starting
Before you begin the installation process, gather these essential components and verify your setup requirements:
Hardware Requirements
The Masjidbox Player itself is a compact, plug-and-play device designed specifically for mosque display systems. You'll also need:
- HDMI TV or Display – Any modern television or digital display with an HDMI input port (1080p or higher recommended for best visual quality)
- HDMI Cable – Included with your Masjidbox Player; connects the device to your TV
- Power Adapter – Included with your device; provides power to the player
- Network Connection – Either an Ethernet cable (recommended) or access to a WiFi network
Network & Internet Requirements
An active internet connection is essential for both initial setup and ongoing operation. Your Masjidbox Player needs internet access to:
- Link your device to the Masjidbox dashboard
- Fetch prayer time calculations and Islamic calendar data
- Sync announcements, events, and content updates
- Receive firmware updates and security patches
Ethernet vs. WiFi: While WiFi is supported, Ethernet is strongly recommended for initial setup because it provides a more stable connection during the linking process. You can switch to WiFi after your device is fully configured and verified.
Workspace Preparation
- Identify where your TV will be mounted (entrance, prayer hall, or announcement area)
- Ensure the TV location has access to power outlets
- Plan your network connectivity (Ethernet cable route or WiFi signal strength)
- Have your Masjidbox dashboard login credentials ready
Step-by-Step Setup Instructions
Step 1: Connect the HDMI Cable
What to do:
- Locate the HDMI port on the back of your Masjidbox Player
- Locate the HDMI input port on your TV (usually labeled HDMI 1, HDMI 2, etc.)
- Connect the included HDMI cable from the player to your TV
- Note which HDMI input you used (you'll need this in Step 4)
Pro tip: If your TV has multiple HDMI ports, use HDMI 1 or 2 for best compatibility.
Step 2: Connect Power to the Player
What to do:
- Locate the power port on the back of the Masjidbox Player
- Connect the included power adapter to the player
- Plug the adapter into a nearby power outlet
- Do not power on yet – wait until you've connected your network cable
Safety note: Use a surge protector if available to protect your device from power fluctuations.
Step 3: Connect Your Network (Ethernet or WiFi)
For Ethernet (Recommended):
- Locate the Ethernet port on the back of the Masjidbox Player
- Connect an Ethernet cable from your mosque's network router to the player
- Ensure the cable is firmly seated in the port
- Proceed to Step 4
For WiFi (Optional – Configure Later): If you prefer WiFi or don't have Ethernet access, you can configure it after linking your device. For now, skip this step and proceed to Step 4. You'll set up WiFi in the "Configure WiFi (Optional)" section below.
Step 4: Power On and Select HDMI Input
What to do:
- Press the power button on the Masjidbox Player (or plug in the power adapter if not already done)
- Turn on your TV
- Using your TV remote, navigate to the HDMI input you connected in Step 1 (e.g., HDMI 1, HDMI 2)
- Wait 2-3 minutes for the player to boot up
What you'll see: After a few minutes, your TV screen will display:
- Your Device ID (format:
mbx-xxxxxx) - A PIN code (4-6 digits)
- Instructions to link your device
Important: Keep this screen visible and note down your Device ID and PIN code. You'll need the PIN to link your device in the next section.
Connecting Your Masjidbox Player to Mosque Displays
Link Your Device via the Dashboard

Now that your player is powered on and displaying its PIN code, you'll link it to your Masjidbox account:
Step 1: Access the Masjidbox Dashboard
- Open your web browser on a computer or mobile device
- Go to your Masjidbox dashboard (typically at
dashboard.masjidbox.comor your custom domain) - Log in with your mosque's account credentials
- Navigate to the Screens section from the sidebar menu
Step 2: Start the Linking Process

- In the Screens section, click the "Link new screen" button
- A dialog box will appear asking for your device PIN code
- Enter the PIN code displayed on your TV (from Step 4 above)
- Click "Link" or "Confirm"
Step 3: Verify the Connection
- Your player will automatically restart and begin downloading your configured content
- After 1-2 minutes, your TV screen will change from the PIN display to your actual content (prayer times, announcements, events, etc.)
- Your device is now successfully linked and operational
Troubleshooting the linking process:
- If the PIN doesn't work, power cycle your player (unplug for 10 seconds, then plug back in) and try again
- Ensure your player has a stable internet connection (Ethernet or WiFi)
- Check that your Masjidbox account has active Masjidbox Screens subscription
Configuring Masjidbox Screens on Your Player
Display Settings & Content Management
Once your player is linked, you can customize how your content appears:
Access Device Settings:
- In the Masjidbox dashboard, go to Screens
- Find your linked device in the list
- Click on your device to open its settings
Key Configuration Options:
| Setting | Purpose | Options |
|---|---|---|
| Display Orientation | Choose how content appears on your TV | Portrait (vertical) or Landscape (horizontal) |
| Prayer Times Method | Select your mosque's Islamic calculation method | ISNA, Muslim World League, Al Azhar, etc. |
| Timezone | Ensure accurate prayer time calculations | Select your mosque's location/timezone |
| Content Playlist | Manage what displays on your screen | Prayer times, announcements, events, Quranic verses |
| Brightness & Contrast | Adjust visual appearance | Slider controls (0-100%) |
| Update Frequency | How often content refreshes | Every 5 minutes, 15 minutes, hourly, etc. |
Adding Content to Your Display
Your Masjidbox Player can display multiple types of content:
- Prayer Times – Automatically calculated based on your mosque's location and method
- Announcements – Important messages, event details, community updates
- Events – Upcoming classes, lectures, community gatherings, special occasions
- Quranic Verses – Daily verses or rotating Islamic content
- Custom Images – Your mosque's logo, banners, or announcements
To add content:
- Navigate to the Content or Announcements section in your dashboard
- Click "Add New" or "Create Announcement"
- Enter your content details (title, description, dates, times)
- Select which screens should display this content
- Click "Publish" – your player will update automatically
Configure WiFi (Optional)
If you want to use WiFi instead of Ethernet, follow these steps:
WiFi Setup Process

Step 1: Access WiFi Settings
- In the Masjidbox dashboard, go to Screens
- Select your linked device
- Click "WiFi Settings" or "Network Settings"
Step 2: Enter Your Network Details
- Find your mosque's WiFi network name (SSID) in the available networks list
- Enter your WiFi password (case-sensitive)
- Click "Connect" or "Save"
Step 3: Wait for Connection
- Your player will restart automatically
- Wait approximately 5 minutes for the device to reboot and connect to WiFi
- Once connected, your TV screen will display your content normally
Step 4: Verify WiFi Connection
- In the dashboard, check your device status – it should show "Connected via WiFi"
- Confirm that content is updating normally on your display
- Once verified, you can safely disconnect the Ethernet cable
WiFi Best Practices
- Keep Ethernet connected during setup – This ensures stability if WiFi connection fails
- Use 2.4GHz WiFi band – More compatible with IoT devices than 5GHz
- Position your router centrally – Ensure strong signal strength in your display area
- Use a strong password – Protect your mosque's network from unauthorized access
- Monitor connection stability – If WiFi drops frequently, consider using Ethernet permanently
Common Setup Issues & Solutions
Device Won't Power On
Problem: The player doesn't turn on after plugging in the power adapter.
Solutions:
- Check that the power outlet is working (test with another device)
- Verify the power adapter is fully inserted into the player
- Try a different power outlet or surge protector
- If the device still won't power on, contact Masjidbox support
PIN Code Not Appearing on TV
Problem: After powering on, the TV screen remains blank or shows "No Signal."
Solutions:
- Verify you selected the correct HDMI input on your TV remote
- Try a different HDMI port on your TV
- Unplug the HDMI cable, wait 10 seconds, and reconnect it firmly
- Power cycle the player (unplug for 30 seconds, then plug back in)
- If still blank, test the HDMI cable with another device to confirm it works
PIN Code Doesn't Work During Linking
Problem: You enter the PIN in the dashboard, but linking fails.
Solutions:
- Verify you're entering the exact PIN shown on your TV screen
- Ensure your player has an active internet connection (check Ethernet cable or WiFi status)
- Power cycle the player and try again with the new PIN
- Check that your Masjidbox account has an active Masjidbox Screens subscription
- Clear your browser cache and try linking again
WiFi Connection Keeps Dropping
Problem: Your player connects to WiFi but frequently disconnects.
Solutions:
- Move your router closer to the player or relocate the player closer to the router
- Switch to the 2.4GHz WiFi band (if your router supports dual-band)
- Reduce interference by moving the player away from microwaves, cordless phones, or other wireless devices
- Consider using Ethernet instead – it's more stable and reliable
- Check your router's WiFi password and re-enter it in the player settings
Content Not Updating on Display
Problem: You've added announcements or changed settings, but the player still shows old content.
Solutions:
- Wait 5-10 minutes – the player updates content periodically
- Manually refresh by power cycling the player (unplug for 10 seconds, plug back in)
- In the dashboard, click "Refresh" or "Sync" next to your device
- Verify your player is connected to the internet (check network status in dashboard)
- Check that your content is set to "Published" (not "Draft")
Multiple Screens Showing Different Content
Problem: You set up multiple players but they're displaying different content.
Solutions:
- Verify all devices are linked to the same Masjidbox account
- In the dashboard, select all devices and assign them to the same content playlist
- Use an HDMI splitter to connect multiple TVs to a single player (all screens will show identical content)
- If you need different content on different screens, each player must be individually configured
Player Overheating or Shutting Down
Problem: The device gets hot or turns off unexpectedly.
Solutions:
- Ensure the player has adequate ventilation (not enclosed in a cabinet)
- Keep the device away from direct sunlight or heat sources
- Clean any dust from the player's vents using compressed air
- Reduce the display brightness setting in the dashboard
- If overheating persists, contact Masjidbox support
Next Steps: Optimizing Your Mosque Display
After Initial Setup
Once your Masjidbox Player is linked and displaying content, consider these optimization steps:
1. Configure Prayer Times Accurately
- Verify your mosque's location is correctly set in the dashboard
- Select the appropriate Islamic calculation method for your region
- Test prayer times against your mosque's printed schedule
- Adjust timezone if needed
2. Create Your Content Playlist
- Add your mosque's announcements and upcoming events
- Set up recurring announcements (daily, weekly, monthly)
- Include special event information (Ramadan schedules, Eid celebrations, etc.)
- Add Quranic verses or Islamic quotes for daily inspiration
3. Set Up Multiple Screens
- If you have multiple display areas (entrance, prayer hall, community room), link additional players
- Use an HDMI splitter to connect multiple TVs to a single player for synchronized displays
- Assign different content to different screens based on location needs
4. Customize Display Settings
- Choose portrait or landscape orientation based on your TV mounting
- Adjust brightness and contrast for optimal visibility
- Set content refresh frequency (how often the display updates)
- Configure font sizes for readability from a distance
5. Integrate with Other Masjidbox Features
- Connect your Masjidbox Screens with the mobile app for community notifications
- Set up donation widgets to display fundraising campaigns
- Enable live streaming integration for remote attendees
- Link your website calendar to automatically sync events
6. Establish Maintenance Routines
- Check player status weekly in the dashboard
- Monitor internet connectivity and WiFi signal strength
- Update firmware when new versions are available
- Clean the display screen regularly for optimal visibility
Ready to Get Started?
Your Masjidbox Player is now set up and ready to serve your mosque community. Here's what you can do next:
Immediate Actions
- Verify your content is displaying correctly – Check that prayer times, announcements, and events appear as expected
- Test all interactive features – Ensure brightness, orientation, and refresh settings work properly
- Confirm network stability – Monitor your connection for the first 24 hours
- Share access with your team – Add other mosque staff to the dashboard so they can manage content
Need Help?
If you encounter any issues during setup or have questions about features:
- Visit the Masjidbox Player documentation for detailed feature guides
- Check our support center for additional troubleshooting articles
- Contact our support team for personalized assistance
Explore Advanced Features
Once you're comfortable with basic setup, explore these advanced capabilities:
- Multiple screen management – Control dozens of displays from a single dashboard
- Custom branding – Add your mosque's logo and colors to displays
- Analytics & reporting – Track engagement and content performance
- API integration – Connect Masjidbox Screens with your existing systems
FAQ
How long does setup take?
Initial setup typically takes 5-10 minutes. Linking your device and configuring basic settings adds another 5-10 minutes.
Can I use WiFi from the start?
Yes, but Ethernet is recommended for initial setup because it provides a more stable connection during the linking process. You can switch to WiFi after verification.
What if I forget my PIN code?
Power cycle your player (unplug for 30 seconds, then plug back in). A new PIN code will display on your TV screen.
Can I move my player to a different location?
Yes. Simply unplug it, move it to the new location, reconnect power and network, and it will automatically sync with your dashboard.
How many screens can I link to one account?
You can link unlimited players to a single Masjidbox account. Each device can be individually configured or grouped for synchronized content.
What happens if my internet connection drops?
Your player will continue displaying the last cached content. Once internet is restored, it will automatically sync with the latest updates.
Can I display different content on different screens?
Yes. Each linked player can have its own content playlist. Alternatively, use an HDMI splitter to connect multiple TVs to a single player for synchronized displays.
Is technical support available?
Yes. Visit the Masjidbox Player support page or contact our support team for assistance.
Useful Sources
- Masjidbox Player Product Page – Complete feature overview and specifications
- Masjidbox Dashboard – Access your account and manage screens
- Masjidbox Support Center – Additional guides and troubleshooting articles