ManualChapter 3 of 7

Finding and Installing Packages

After this chapter you can find a package, install it or remove it, and know that nothing on your device changes until you tap Execute. Every request you make, from any page, first becomes a change you review and then waits in the queue. Removing, updating, and downgrading a package follow the same path as installing one.

A Package's Page

A package's page opens with its artwork. Below that is a banner with the package's icon, its name, its version and download size, and one button. The description the repository publishes follows. The last line of the page names what the package was built for, such as Architecture: iphoneos-arm64.

The button names the next thing you can do with this package. Most of its labels are shown in capitals.

ButtonWhen You See ItWhat a Tap Does
Install or BuyThe package is not installed. A paid package reads Buy.Asks to install it.
UpdateThe package is installed and this page shows a newer version.Asks to update it.
ActionsThe package is installed and there is nothing quick to do.Opens the menu.
Open QueueThe package is already in the queue.Opens the queue.
ReplaceThe package is in the queue as a different version from the one on this page.Asks to queue this version in its place.
UnsupportedThe package is not built for this device.Queues nothing, and explains why.

The explanation behind Unsupported is titled Unsupported Architecture and reads, for example, This package is built for iphoneos-arm64. This device uses iphoneos-arm64e. Choose a compatible package, or use Apelin to rebuild this one for this device.

Irisin lists only packages built for your device's architecture, or for every architecture (all). A package built for the other bootstrap is not listed at all. You meet Unsupported only on a .deb you opened yourself, or on a package already installed for the other bootstrap. Irisin does not convert packages. Apelin can rebuild such a package for this device.

A package's page: artwork, then a banner with the icon, name, version and size and an INSTALL button, then the description. A package's page: artwork, then a banner with the icon, name, version and size and an INSTALL button, then the description.
A package's page. The button names the next thing you can do.

A tap never installs. It opens the Queue Changes sheet, which shows what the request would do and waits for you to confirm. See The Queue.

When you open a page from Installed, Irisin shows the repository's record for that package where there is one: the newest update on offer, or else the repository it was installed from. That is why the page can offer Update or Reinstall for something already on your device.

Open a .deb File

  1. In Files, open a .deb with Irisin. Irisin works on a copy. Your file stays where it is.
  2. Wait while Irisin shows Unpacking Package…
  3. The package's page opens. Its button reads Install and its menu offers Direct Install. Either goes through the same Queue Changes sheet as any other request.

If the file cannot be read as a package, Irisin says This package could not be verified. Choose a different file and try again.

The Package Menu

One menu holds everything you can do with a package. It opens from three places: touch and hold the button on the package's page, tap the … button in that page's bar, or touch and hold a package row in any list.

The menu shows only what applies right now. If the item you want is missing, this list says why.

  • Install: the package is not installed, is built for this device, and has a download.
  • Update: the version on the page is newer than the installed one, and you have not blocked this package's updates.
  • Downgrade, in red: the version on the page is older than the installed one.
  • Remove, in red: the package is installed.
  • Remove from Queue: the package is in the queue.
  • Replace: the package is in the queue as a different version, and the version on the page can be installed.
  • Direct Install: the page came from a .deb you opened, and that package is not installed.
  • Choose Version: always.
  • Translate: on a package's page only, not in the menu of a row. See The Translate Menu.
  • Advanced: a submenu at the end, with these items.
    • Reinstall: the version on the page is the installed one.
    • Block Update or Unblock Update: one or the other. Either takes effect at once. See Block an Update.
    • Download Archive: the package comes from a repository and has a download.
    • View Package Info: opens Package Info, a read-only list of every field the repository published for this package.
    • Reveal Files: installed packages only. It lists the files the package placed on your device. The page's menu has Export List, which shares the list as plain text, and Repack, which builds a .deb from the files on your device and shares it. A repacked package includes any changes made since installation, so it may differ from the downloaded package.

While a package is in the queue, none of Install, Update, Reinstall, Downgrade, Remove, or Direct Install is offered. Choose Remove from Queue first, then ask again.

When Irisin Recommends Another

Before the sheet opens for an install request, Irisin compares what your other repositories offer for the same package. When another repository has a newer version, it stops you with Newer Version Available. The alert reads, for example, You selected version 1.0. Procursus offers version 1.1. It never appears for a package whose updates you blocked.

The alert has three buttons. Select Recommended opens the recommended package's page and queues nothing; ask again there. The second button goes ahead with what you chose, and is named after your request: Install Anyway, Update Anyway, Downgrade Anyway, Reinstall Anyway, or Replace Anyway. Cancel drops the request.

When a request names a package with no version that can be installed, Irisin stops with Unable to Load Package and the message This package could not be loaded. Try a different repository.

Choose Version

  1. Open the package's menu and choose Choose Version.
  2. A sheet lists every version on offer, one group per repository. The version the page is showing has a checkmark. Cancel closes the sheet with nothing changed.
  3. Tap a version. The sheet closes and the page shows that version. If you opened the menu from a row in a list, the version opens on a page of its own.
  4. Now use the page's button or menu to ask for it.

Choosing a version queues nothing. It only changes which version the page, its button, and its menu refer to.

A version older than the installed one shows Downgrade in the menu, in red. The sheet lists only versions a repository still offers, so an older version that every repository has dropped cannot be chosen here.

When the page is showing a .deb you opened, or a package that only your device has a record of, the sheet adds the header Current Selection: Local Version above the repositories, and no version has a checkmark.

After a downgrade, the newer version is an update again. To keep the older one, see Block an Update.

Download Archive

This saves a package's .deb file without installing it.

  1. Open the package's menu, then Advanced, then Download Archive.
  2. A card appears over the page with the package's name, a progress bar, and a status line that reads Preparing…, then Downloading…, then Verifying… Under the bar, a count such as 1.2 MB of 3.4 MB shows how much has arrived. A file Irisin has already downloaded finishes at once.
  3. The share sheet opens with the file, named <identifier>_<version>_<architecture>.deb. Save it or send it from there.

For a paid package, Irisin checks your purchase first, and the card opens on Checking Purchase… If you are not signed in to the repository that sells it, sign-in starts instead and nothing is downloaded. Cancel on the card stops the download and closes it. If the download fails, the card closes and Irisin reports Download Failed with The download was interrupted.

Download Archive is offered only for a repository's package that has a download. A .deb you opened is already a file, so its menu does not have the item.

The Queue

Every request you make, whether to install, update, downgrade, reinstall, or remove, goes through one sheet. What you confirm there waits in the queue until you run it.

  1. Installon the package's page
  2. Confirmthe Queue Changes sheet
  3. Queuethe tab or floating bar
  4. Executethe queue's one button
  5. Installingthe operation pageCompleted

The downloads start at Confirm and run while the queue waits.

From a package's page to a finished install.

The Queue Changes Sheet

The sheet is titled Queue Changes. It lists what your request would do, in groups, in this order: Install, Update, Downgrade, Remove, Reinstall. Within each kind, what you asked for comes first. What the plan brings along follows in a group of its own, such as Install (Dependencies).

A row shows the package's name and, at its right edge, the version: 1.1 for an install or a reinstall, 1.0 → 1.1 for an update or a downgrade, and the installed version for a removal. Under the name it says how much is left to download (2.1 MB to download, left out when the file is already on your device), how much room it takes (6.4 MB on disk), and, for a package you did not ask for, why it is there: Required by OpenSSH. A removal's name is red and struck through. A new install's name is green.

The Queue Changes sheet with an Install group, an Install (Dependencies) group, each row's version and sizes, a footer, and the Confirm button. The Queue Changes sheet with an Install group, an Install (Dependencies) group, each row's version and sizes, a footer, and the Confirm button.
Queue Changes shows what you asked for, then what it brings along.

No Longer Needed appears when the plan removes something and leaves behind dependencies that nothing else needs. Each has a checkbox, and none is checked, so they stay installed unless you say otherwise. Check one to remove it too, and the sheet works out the plan again. A grayed row cannot be checked yet: something you left unchecked still needs it, and the row names it.

No Longer Queued lists, grayed, what this change takes back out of the queue.

When the change adds anything, the sheet's footer says After you confirm, the queue prepares everything the install needs. Finish installing from the Queue page. Tap Confirm to add exactly what the sheet shows. The sheet closes, a banner reports Added to Queue, and you stay on the page you were on. Confirm does not open the queue and installs nothing. To leave without changing anything, pull the sheet down. It has no cancel button.

Open Queue takes the place of Confirm when the change alters nothing. The sheet then holds one row, Already in the queue or No changes.

If the change cannot be planned, there is no list. The sheet is a report titled Unable to Prepare Installation. See When a Plan Cannot Be Made.

The Floating Bar

While there is a queue, a bar reading Packages in Queue: 3 floats at the bottom of every page except the queue's own, clear of the tab bar. The number counts the packages the queue installs plus the ones it removes. Tap the bar to open the queue. The Queue tab is there while there is a queue, and carries the same number as its badge.

The Queue Page

Open the queue from the Queue tab or the floating bar. The page reads like the sheet: the same groups, requests ahead of their dependencies, versions and sizes on each row. Downloads start the moment you confirm, whether or not this page is open. Each row fills with tint from its leading edge as its file arrives. Its right edge shows a spinner, then a percentage, then Downloaded, or Failed in red. Removals and .deb files you opened have nothing to download and show nothing there.

The Queue page with rows partly downloaded, a percentage or Downloaded at each row's right edge, and the Execute button in the bar. The Queue page with rows partly downloaded, a percentage or Downloaded at each row's right edge, and the Execute button in the bar.
The queue downloads while you decide. Execute runs it.

Notices appear at the end of the list. OpenSSH: kept at the current version by another package or a blocked update. names an update the plan could not take. Irisin will restart when this finishes. appears when the queue updates Irisin itself.

To take one package out, swipe its row left and tap Remove from Queue. This goes through the same sheet, and removing a dependency also takes out the packages that need it. The … menu has two items. Export All Packages shares the downloaded files. It is grayed with Available once the downloads finish. while a file is missing, or The queue installs nothing. when there is nothing to export. Clear Queue empties the queue and cancels its downloads.

A red row at the top of the list means the packages on your device changed, so the queue can no longer be planned as it stands. The row gives the reason. The action button is disabled until you change the queue, by taking a package out of it or clearing it.

Execute

The Queue page has one action button in its bar, and its label tells you what is next.

  • Execute runs the queue.
  • Queue Install appears in its place while files are still downloading. Tap it and the queue runs when the last file arrives. The button then reads Cancel Auto Install, in red, which takes that back.
  • Retry appears after a download failed or the queue could not be prepared.

You do not have to wait for the downloads. A spinner takes the button's place while Irisin works.

Execute opens the operation page, titled Installing, full screen on iPhone. When the title becomes Completed, the queue is cleared. The floating bar goes away, and so does the Queue tab once you leave it. After a failure the queue stays, planned again against what the run left on your device, so you can run what remains. For a run that ends on Failed, see Read the Operation Page.

Three messages can stop the button before anything runs.

  • Another operation is already running. Wait for it to finish, then try again. Only one operation runs at a time.
  • Unable to prepare this operation. Try again. The button becomes Retry, which prepares the queue again.
  • The download was interrupted. A failed download shows its reason as a red row, and Retry downloads again. For a purchased package the row adds A purchased package's download link expires. Remove it from the queue and add it again.

A Queued Package's Details

Before you run the queue, you can read what each package will do to your device. A row on the Queue page opens once there is something to read: a removal at any time, anything else once its file is downloaded. A chevron at the row's right edge tells you it opens.

The page is titled with the package's name and has two sections. Files has three rows, each with a count: New Files, Replaced Files, and Deleted Files. Tap a count above zero to read the paths. Replaced Files is tinted when it is above zero: look there first, because those are files already on your device that this package overwrites. When some of them belong to other installed packages, a line under the section names them: 2 of the replaced files belong to OpenSSH.

Scripts lists the package's scripts in the order they will run. Each is marked Installed, for a script of the version on your device, or Incoming, for one the new file brings. Tap a script to read it. One that is not text is marked as binary and does not open. The section's footer reads The scripts run as root, in this order. A package with none says No scripts.

This page is read-only. Nothing on it changes the queue, and you can run the queue without opening it. While Irisin reads the file, one row says Reading the package… If it cannot, a red row says Unable to read this package.

The Installed Page

The Installed tab lists what is on your device. Under the list, a line such as Packages: 212 · Sections: 14 counts what is shown after your search and filter.

Swipe a row left for buttons that show a symbol and no name. They stand for whichever of Remove from Queue, Remove, Update, and Reinstall apply to that package, in that order from the edge. Each asks for the same thing as the matching menu item, and a long swipe alone asks for nothing. A window wide enough to show the packages in columns has no swipe buttons. Touch and hold a row for the full menu, in that layout and in every list. Tap it for the package's page.

The … menu holds the rest.

  • Refresh reads again what is installed, not your repositories, and confirms with Installed packages refreshed. Pulling the list down does the same.
  • Select starts a selection, described below.
  • Block All Updates, in red, is there only while an update is found. See Block an Update.
  • Export Package List and Export dpkg Status share a record of what is installed. See The Menu and Exports.
  • Filter narrows the list by Section or by Author.
  • Sort By orders it by Name or by Last Modified, Ascending or Descending.

To act on several packages at once:

  1. Open the … menu and choose Select.
  2. Check the rows you want.
  3. Tap Remove or Update in the bar. One Queue Changes sheet covers the whole selection.

Among several selected rows, one that is already in the queue is left out of a removal. Take it out of the queue first. A paid package is left out of an update, because its purchase is checked from its own page. When a batch leaves something out, Irisin says Some Packages Left Out and Open their pages instead.

When an update is found, the bar shows an up arrow, which opens Updates. Otherwise it shows a green checkmark, and a tap on it reports All packages are up to date. See Updates.

If the wrong package is installed, Remove it here. If it is the right package in the wrong version, open its page, use Choose Version, pick the one you want, and then choose Downgrade. A package the system requires cannot be removed unless Power Operations is on. See Power Operations.