background
Tutorials

Setup Masjidbox Player for Mosque Displays

Published on Feb 17, 2026

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:

  1. Locate the HDMI port on the back of your Masjidbox Player
  2. Locate the HDMI input port on your TV (usually labeled HDMI 1, HDMI 2, etc.)
  3. Connect the included HDMI cable from the player to your TV
  4. 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:

  1. Locate the power port on the back of the Masjidbox Player
  2. Connect the included power adapter to the player
  3. Plug the adapter into a nearby power outlet
  4. 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):

  1. Locate the Ethernet port on the back of the Masjidbox Player
  2. Connect an Ethernet cable from your mosque's network router to the player
  3. Ensure the cable is firmly seated in the port
  4. 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:

  1. Press the power button on the Masjidbox Player (or plug in the power adapter if not already done)
  2. Turn on your TV
  3. Using your TV remote, navigate to the HDMI input you connected in Step 1 (e.g., HDMI 1, HDMI 2)
  4. 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)
  • 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

Masjidbox dashboard showing the Screens section in the sidebar to link a device using its PIN code

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

  1. Open your web browser on a computer or mobile device
  2. Go to your Masjidbox dashboard (typically at dashboard.masjidbox.com or your custom domain)
  3. Log in with your mosque's account credentials
  4. Navigate to the Screens section from the sidebar menu

Step 2: Start the Linking Process

Masjidbox dashboard showing the Link new screen button to connect a player using a PIN code

  1. In the Screens section, click the "Link new screen" button
  2. A dialog box will appear asking for your device PIN code
  3. Enter the PIN code displayed on your TV (from Step 4 above)
  4. Click "Link" or "Confirm"

Step 3: Verify the Connection

  1. Your player will automatically restart and begin downloading your configured content
  2. After 1-2 minutes, your TV screen will change from the PIN display to your actual content (prayer times, announcements, events, etc.)
  3. 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:

  1. In the Masjidbox dashboard, go to Screens
  2. Find your linked device in the list
  3. Click on your device to open its settings

Key Configuration Options:

SettingPurposeOptions
Display OrientationChoose how content appears on your TVPortrait (vertical) or Landscape (horizontal)
Prayer Times MethodSelect your mosque's Islamic calculation methodISNA, Muslim World League, Al Azhar, etc.
TimezoneEnsure accurate prayer time calculationsSelect your mosque's location/timezone
Content PlaylistManage what displays on your screenPrayer times, announcements, events, Quranic verses
Brightness & ContrastAdjust visual appearanceSlider controls (0-100%)
Update FrequencyHow often content refreshesEvery 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:

  1. Navigate to the Content or Announcements section in your dashboard
  2. Click "Add New" or "Create Announcement"
  3. Enter your content details (title, description, dates, times)
  4. Select which screens should display this content
  5. 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

Masjidbox dashboard device management page showing the WiFi Setting option to configure wireless connection

Step 1: Access WiFi Settings

  1. In the Masjidbox dashboard, go to Screens
  2. Select your linked device
  3. Click "WiFi Settings" or "Network Settings"

Step 2: Enter Your Network Details

  1. Find your mosque's WiFi network name (SSID) in the available networks list
  2. Enter your WiFi password (case-sensitive)
  3. Click "Connect" or "Save"

Step 3: Wait for Connection

  1. Your player will restart automatically
  2. Wait approximately 5 minutes for the device to reboot and connect to WiFi
  3. Once connected, your TV screen will display your content normally

Step 4: Verify WiFi Connection

  1. In the dashboard, check your device status – it should show "Connected via WiFi"
  2. Confirm that content is updating normally on your display
  3. 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:

  1. Check that the power outlet is working (test with another device)
  2. Verify the power adapter is fully inserted into the player
  3. Try a different power outlet or surge protector
  4. 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:

  1. Verify you selected the correct HDMI input on your TV remote
  2. Try a different HDMI port on your TV
  3. Unplug the HDMI cable, wait 10 seconds, and reconnect it firmly
  4. Power cycle the player (unplug for 30 seconds, then plug back in)
  5. 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:

  1. Verify you're entering the exact PIN shown on your TV screen
  2. Ensure your player has an active internet connection (check Ethernet cable or WiFi status)
  3. Power cycle the player and try again with the new PIN
  4. Check that your Masjidbox account has an active Masjidbox Screens subscription
  5. Clear your browser cache and try linking again

WiFi Connection Keeps Dropping

Problem: Your player connects to WiFi but frequently disconnects.

Solutions:

  1. Move your router closer to the player or relocate the player closer to the router
  2. Switch to the 2.4GHz WiFi band (if your router supports dual-band)
  3. Reduce interference by moving the player away from microwaves, cordless phones, or other wireless devices
  4. Consider using Ethernet instead – it's more stable and reliable
  5. 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:

  1. Wait 5-10 minutes – the player updates content periodically
  2. Manually refresh by power cycling the player (unplug for 10 seconds, plug back in)
  3. In the dashboard, click "Refresh" or "Sync" next to your device
  4. Verify your player is connected to the internet (check network status in dashboard)
  5. 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:

  1. Verify all devices are linked to the same Masjidbox account
  2. In the dashboard, select all devices and assign them to the same content playlist
  3. Use an HDMI splitter to connect multiple TVs to a single player (all screens will show identical content)
  4. 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:

  1. Ensure the player has adequate ventilation (not enclosed in a cabinet)
  2. Keep the device away from direct sunlight or heat sources
  3. Clean any dust from the player's vents using compressed air
  4. Reduce the display brightness setting in the dashboard
  5. 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

  1. Verify your content is displaying correctly – Check that prayer times, announcements, and events appear as expected
  2. Test all interactive features – Ensure brightness, orientation, and refresh settings work properly
  3. Confirm network stability – Monitor your connection for the first 24 hours
  4. 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

Ready to Get Started?

You now have all the information you need to set up your Masjidbox Player. Explore compatible devices and advanced features to find the perfect solution for your mosque.

Related posts

Which Way Is the Qibla?
Tutorials

Jan 16, 2026

Which Way Is the Qibla?

Not sure which way to pray? Learn how to find the Qibla direction from anywhere using your phone, Google Maps, or simple natural methods.