Help & support

Recognise the official IROMUSIC, install the right version for your device, and fix the usual problems step by step.

Is this the official IROMUSIC?

IROMUSIC (آیروموزیک in Persian) is an app for music, movies and series, also written آیر موزیک, ایروموزیک, Iro Music or iromusic live; they all mean this one app.

The official site is iromusic.live and the web app runs at web.iromusic.live. Get install files only from the pages of this site; its download buttons point to files on cdn.web.ir.s3.hostchin.com/downloads/.

How do I recognise an official build?

Modded, cracked and "hack" versions are not ours

We do not publish modded, cracked or "hacked" versions of IROMUSIC. A file offered under that label on another site or channel was altered and repackaged by someone else, and we do not know what was added to it.

The risk is real: such a file can carry malware or hidden adware, read your sign-in details and put your account at risk, and because it is not signed with our key it gets no updates through the official route. If you installed one, uninstall it, change your account password and install the official release from the download page.

Which version should I use?

The web app needs no install and works in desktop and mobile browsers. For a native app, take the APK on Android, the EXE on Windows 10 or later, the DMG or the one-line command on macOS, and the deb package on Linux (Ubuntu 24.04 or newer); on Android TV, sideload the same Android APK. There is no iOS app: on iPhone and iPad, open the web app in Safari.

If you would rather have IROMUSIC in a browser tab, the browser extension for Chrome, Edge, Brave and Firefox opens the web app in its own tab from the toolbar. You install it by hand from a zip file.

Install problems and an app that won't open

Android

Android TV

Install the same Android APK on the TV; once installed, IROMUSIC appears in the TV home screen's app list as an Android TV app. The manual install steps are on the Android TV page.

Windows

The Windows app (EXE, x64) needs Windows 10 or later. The installer has no digital signature; if SmartScreen warns you, choose "More info › Run anyway". Windows 7 and 8 are not supported and the installer refuses to run on them; use the web app there. Details are on the Windows page.

macOS

The Mac app (Apple Silicon and Intel) is not notarized by Apple yet. This command installs it so that it opens normally:

curl -fsSL https://iromusic.live/install.sh | bash

If a DMG you downloaded by hand is reported as damaged, run xattr -dr com.apple.quarantine /Applications/iromusic.app in Terminal once. Details are on the macOS page.

Linux

The deb package (amd64 and arm64) needs Ubuntu 24.04 or newer, which means glibc 2.38 or later; apt refuses Ubuntu 22.04 and older, so use the web app there. The install command above (the same as on macOS) picks the right architecture itself and installs the libraries the app needs.

If you install the deb by hand, use sudo apt install ./FILE.deb so that dependencies such as libgles2 and libegl1 are installed too; without libgles2 the app closes at startup. Details are on the Linux page.

Installed, but the app won't open

  1. Make sure you are on the latest release; if in doubt, reinstall from the official download links.
  2. Check your internet connection.
  3. Clear the app's cache (or your browser's cache, for the web app).
  4. Reinstall the official release.
  5. Still stuck? Contact us via the link in the footer with your device model and OS version.

iPhone and iPad

There is no iOS app. On iPhone and iPad, open the web app in Safari and add it to your Home Screen:

  1. Open web.iromusic.live in Safari.
  2. Tap the Share icon.
  3. Choose "Add to Home Screen."
  4. Launch it from your Home Screen like a regular app.

More detail is on the web app and iPhone page.

Updates and older versions

When a newer release is published, the installed apps show an update screen at startup (optional or required). On Android the app downloads the file itself, checks its SHA-256 and hands it to the system installer; on the other platforms the download link opens in your browser.

The latest release and earlier ones are listed on the releases page. If your device needs an older version for compatibility, take it from that page, not from another site.

If an old version shows a required-update screen, install the new version from your platform's download page.

Telegram

The official IROMUSIC channel @Iromusic_club posts release announcements and new versions. The bot @IromusicLiveBot puts songs from the app into your Telegram chat as audio files, and works for music only.

  1. In the app, open Settings, then Telegram, then Connect (or tap "Send via Telegram" the first time).
  2. The bot opens; press Start so your chat is linked to your IROMUSIC account.
  3. From then on, "Send via Telegram" on a song delivers the audio file straight to your chat. You can disconnect in Settings at any time.

Do not treat a channel or bot as official if it claims to be but is not linked on this page.

Still need help

Check the FAQ for more answers, or reach us through the contact link in the footer of this site; include your device model, OS version, IROMUSIC version and the error text.