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?
- Where it came from: you downloaded it from your platform's page on this site: Android, Android TV, Windows, macOS or Linux. Take earlier versions only from the releases page.
- SHA-256: the hash of your file equals the value shown on that platform's page and in SHA256SUMS.txt. Windows:
certutil -hashfile FILE SHA256; macOS:shasum -a 256 FILE; Linux:sha256sum FILE. - Updates on Android: an official release keeps the same package name and the same signing key as the previous one, so it installs over the existing app. Android refuses to install a copy signed with a different key over the official app (and the other way round) and shows "App not installed". That is a useful sign, but it does not replace comparing the SHA-256.
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.
- iPhone and iPad: the web app and Add to Home Screen
- Android phones and tablets (ARM or x86_64 processors): Android download
- Android TV: download and install on Android TV
- Windows 10 or later (x64): Windows download
- Mac (Apple Silicon and Intel): macOS download
- Linux (Ubuntu 24.04 or newer, amd64 and arm64): Linux download
- Every option in one place: the download page
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
- Permission to install: when you open the APK from your browser or file manager, Android asks once to allow that app to "Install unknown apps". The wording differs a little between phones.
- "App not installed": if a copy with a different signature (for example an unofficial one) is already installed, uninstall it and install the official release again from the Android page.
- x86 processors: the direct APK is universal (arm64-v8a, armeabi-v7a and x86_64), so it installs on phones, tablets, x86_64 emulators, Chromebooks and TV boxes. Only 32-bit x86 devices are not supported; use the web app there.
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
- Make sure you are on the latest release; if in doubt, reinstall from the official download links.
- Check your internet connection.
- Clear the app's cache (or your browser's cache, for the web app).
- Reinstall the official release.
- 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:
- Open web.iromusic.live in Safari.
- Tap the Share icon.
- Choose "Add to Home Screen."
- 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.
- In the app, open Settings, then Telegram, then Connect (or tap "Send via Telegram" the first time).
- The bot opens; press Start so your chat is linked to your IROMUSIC account.
- 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.