মোবাইল অ্যাপস
নিজের অ্যাপ বানান: ইনস্টল করা যায় এমন ওয়েব অ্যাপ, GitHub-এ বিল্ড হওয়া Android ও iPhone প্রজেক্ট, আর QR কোড স্ক্যান করে কম্পিউটারে সাইন-ইন।
Mobile Apps turns your site into an app of its own, four ways at once:
- An installable web app that works at once on Android, and on iPhone through Add to Home Screen - nothing to build.
- An Android project (Kotlin) with a GitHub workflow that builds the APK on GitHub's machines, so you never install Android Studio.
- An iPhone project (Swift, generated with XcodeGen) with a workflow that builds it on GitHub's Macs.
- A Smart TV app - TV screens any TV browser opens, an Android TV / Google TV project, and Samsung Tizen and LG webOS projects.
All of them show the site's own pages, so whatever you change on the site is in the app at once, with no store update. On top of that, a member signed in on the phone can sign a computer or a TV in by scanning a QR code.
Before you start
- The site must run on https. Phones install web apps, and give the camera to a page, only on https.
- Downloading the projects needs PHP's ZipArchive; the icon sizes are made with GD.
Switching it on
Mobile Apps is a free plugin and works with every licence. Switch it on at Admin → Plugins. It makes the table aio_qr_logins and the folder uploads/apps, and takes the app's first name and colour from your site name and brand colour.
The admin menu then shows a Mobile Apps group under Plugins with App builder (admin/plugin.php?code=mobile-apps), Packages & downloads and Smart TV. Until you upload an icon, the panel's bell carries a quiet note: The app has no icon of its own yet.
The App builder
On the right is a phone showing the site as the app will. It follows every change as you type, before you save.
The app
- App name and Short name (under the icon, 12 letters).
- Package / bundle id - reverse-domain, lower case:
com.yoursite.app. Changing it later makes a different app in the stores. - Version.
- A line about the app - for store listings and the Get the app page.
Look
- Icon (square PNG, 512 × 512 or larger) - or tick use the default mark instead.
- Theme colour (status bar, tab bar highlight), Background colour (splash, offline page) and Splash / icon background.
- Opens on - a path on the site:
/,/trending,/plugins/shorts/feed. - Orientation - Any, Portrait only or Landscape only.
- Bottom tab bar - the row of tabs along the bottom.
- Hide the site's top bar inside the app - leaves only the page and the tabs.
- Offer to install - a small card on phones that can install the app, once a week at most.
- Sign in with the phone (QR) - see below.
Bottom tabs (up to five) - a label, an icon and where it goes (a path or a full address). The defaults are Home, Trending, Create, Subscriptions and You; Create gets the raised button. Leave a label empty to drop a tab.
Store links (optional) - Google Play address and App Store address, shown on Get the app once you have published there.
Press Save the app. The web app updates by itself; rebuild the Android and iPhone packages when the name, icon, colours or tabs change.
The tab bar and the hidden top bar apply only inside the app: an installed web app, a page opened with ?app=1, or the Android and iPhone shells.
Packages & downloads
1. The web app - ready now. The manifest, service worker, icons and offline page already work. On Android, Chrome offers Install or Add to Home screen; on iPhone, Safari → Share → Add to Home Screen.
2. Android package (APK). Press Download the Android project (.zip). It wraps the site in a WebView with camera, microphone and file access, so going live and uploading work inside it. Then:
- Unzip it and upload its contents to a GitHub repository (private is fine).
- Open the repository's Actions tab; the Build Android APK workflow runs by itself.
- When it is green, download app-debug.apk from the run's artifacts.
- Upload that APK under step 4 below.
For Google Play you need a release build signed with your own key: the project's README-BUILD.md shows how to add it as repository secrets, after which the workflow builds a signed release too. Keep that key safe; Google Play only accepts updates signed with it.
3. iPhone package (Xcode). Download the iOS project (.zip) and put it in a GitHub repository. The Build iOS app workflow makes an unsigned build you can run in the Simulator. On a Mac, brew install xcodegen && xcodegen makes the .xcodeproj to open in Xcode, where you choose your team under Signing and press Run or Archive. The App Store, or a phone that is not in developer mode, needs an Apple Developer account to sign the app.
4. The APK members download. Choose the .apk and press Save - or, for a file too big for the server's upload limit, send it by FTP to uploads/apps/ and pick it in Or a file already in uploads/apps/; Get the app then offers it with a download button. Tick take it down to remove it. Keep the Version in the builder in step with the APK. The page shows the server's upload limit; a larger APK needs a higher upload_max_filesize and post_max_size.
Smart TV
The TV screens - ready now. /plugins/mobile-apps/tv is the site made for a television: big cards in rows (Continue watching and From your subscriptions for a signed-in member, Featured, Latest videos, Trending, Most viewed, Shorts and Live when those plugins are on, then the categories), tabs for Home, Live, Shorts, Search and Sign in. The remote's arrows move a focus ring, OK opens, Back returns; the video plays in the AIO Player on the whole screen - OK plays and pauses, left and right skip, up and down change the volume, the media keys work too. A mouse, LG's pointer remote or a finger work as well. Any smart TV's browser opens it; nothing to install.
The TV app - on the Smart TV tab:
- TV screens on - off, the page answers "not here" to everybody but administrators.
- Name on the TV, Package id of the TV app (different from the phone app's, so both fit on one Android device), Version.
- Accent colour (focus, buttons, banner) and Look - dark is best on a TV; the viewer can switch, and the choice is kept.
- The Back key on Home - up to the tabs and then "press Back again to leave", up to the tabs and then leave, or leave at once.
- Screensaver after - minutes without a key (0 = never).
- Banner for Android TV (320 × 180) - made from the icon, the name and the colour until you upload one; a bigger picture is cut to size.
- "Link this TV" with a phone - see below.
- The rows on the TV's Home - tick the rows to show. Other plugins add rows of their own (Live TV, for one).
Link this TV. The Sign in tab shows a QR code and an 8-character code for two minutes. On a phone that is signed in, scan the code with the camera or open /plugins/mobile-apps/scan and type it; the phone asks Sign this TV in?; press Yes, sign it in and the TV signs itself in. You → Sign out on the TV signs it out. Sign in with a password is there too.
The TV packages.
- Android TV / Google TV - Download the Android TV project (.zip): a Kotlin WebView app with the Android TV launcher entry and banner, the Back key that asks the page first, and a GitHub Actions workflow that builds the APK, as for the phone app. To install it on a TV: Settings → Device Preferences → About → press Build seven times, allow Install unknown apps, then use the free Downloader app with your Get the app address, or a USB stick. Google Play needs a signed release build (see
README-BUILD.md). - Samsung (Tizen) - Download the Samsung project (.zip):
config.xml,index.htmland the icon. Build and sign the.wgtwith Tizen Studio and a Samsung certificate, then install it on a TV in developer mode, or publish it on the Samsung Apps TV Seller Office.README-TIZEN.mdhas the steps. - LG (webOS) - Download the LG project (.zip):
appinfo.json,index.htmland the icons. Package the.ipkwithares-packagefrom the webOS CLI and install it withares-installon a TV in developer mode, or publish it on the LG Seller Lounge.README-WEBOS.mdhas the steps.
The TV packages members download - upload the built .apk, .wgt or .ipk; Get the app then shows the download buttons under Smart TV, next to the TV browser address and the install steps.
What members see
- Get the app in the account menu, leading to
/plugins/mobile-apps/get: an Install the app button where the browser allows it, the iPhone steps, the APK and store buttons when you have them, and a QR code that opens the page on a phone. - The install card on phones, if Offer to install is on.
- Get the app also has a Smart TV part: the TV browser address, the Android TV steps, and the Samsung and LG files when you uploaded them.
- Without a connection, the installed web app shows an offline page with your logo and Reel Rush, a small game that saves itself and says when the network is back.
Signing in with the phone
With Sign in with the phone (QR) on, the sign-in page on a computer shows Or sign in with your phone: a QR code and an 8-character code that work for two minutes (New code makes another).
- On the phone - in the app or any browser, signed in - scan the QR code with the camera, or open
/plugins/mobile-apps/scanto scan it or type the code. - The phone asks Sign this computer in?. Press Yes, sign it in only if the computer is yours.
- The computer signs in by itself.
A job in Admin → Cron jobs, QR sign-in codes, clears expired codes every hour.
With the Mobile API
For an app with screens of its own, see Mobile API. When it is on, this plugin adds the routes app/config and qr/approve.
With Online / Offline
When the Online / Offline plugin is on, the site has one service worker for the browser, the phone app and the TV app: Mobile Apps registers it and keeps its own files in it. See Online / Offline.
Honest limits
- The Android and iPhone apps are frames around the site: they show the live pages, so they need a connection (without one they say so and offer Try again).
- Publishing on the App Store needs a paid Apple Developer account; Google Play needs a signed release build.
- No APK,
.wgtor.ipkis built on your server: the Android TV project is built by GitHub Actions; Samsung and LG packages need their makers' tools and certificates.