{"id":26923005,"url":"https://github.com/ij-plugins/ijp-imagej-launcher","last_synced_at":"2026-03-05T16:49:57.231Z","repository":{"id":167406821,"uuid":"643028047","full_name":"ij-plugins/ijp-imagej-launcher","owner":"ij-plugins","description":"IJP ImageJ Launcher is native launcher that starts ImageJ 2 or Fiji","archived":false,"fork":false,"pushed_at":"2025-01-23T01:56:57.000Z","size":313,"stargazers_count":23,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-23T02:34:16.482Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ij-plugins.png","metadata":{"files":{"readme":"ReadMe.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-19T22:56:19.000Z","updated_at":"2025-01-23T01:57:01.000Z","dependencies_parsed_at":"2025-01-23T02:31:13.744Z","dependency_job_id":"809abcee-7703-4f09-a6c1-e9c5a2bf021f","html_url":"https://github.com/ij-plugins/ijp-imagej-launcher","commit_stats":null,"previous_names":["ij-plugins/ijp-imagej-launcher"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ij-plugins%2Fijp-imagej-launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ij-plugins%2Fijp-imagej-launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ij-plugins%2Fijp-imagej-launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ij-plugins%2Fijp-imagej-launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ij-plugins","download_url":"https://codeload.github.com/ij-plugins/ijp-imagej-launcher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246735377,"owners_count":20825223,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-02T00:38:29.937Z","updated_at":"2025-10-24T19:51:30.843Z","avatar_url":"https://github.com/ij-plugins.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"IJP ImageJ Launcher\n===================\n\nIJP ImageJ Launcher is a native launcher that starts [ImageJ 2] or [Fiji].\nIt is intended to be a general drop-in replacement for the original [ImageJ Launcher].\nIJP ImageJ Launcher is a clean implementation on the core function of starting [ImageJ 2] or [Fiji].\n\n**Contents**\n\u003c!-- TOC --\u003e\n\n* [Why Another ImageJ Launcher?](#why-another-imagej-launcher)\n* [Features](#features)\n* [Full List of Command Line Options](#full-list-of-command-line-options)\n* [Installation](#installation)\n    * [Installing Fiji on Mac OS X Arm64](#installing-fiji-on-mac-os-x-arm64)\n    * [Installing Fiji on Windows x64](#installing-fiji-on-windows-x64)\n    * [Troubleshooting](#troubleshooting)\n        * [Start-up log `~/.ijp_imagej_launcher.log`](#start-up-log-ijpimagejlauncherlog)\n        * [Starting from command prompt](#starting-from-command-prompt)\n* [Developer Setup](#developer-setup)\n\n\u003c!-- TOC --\u003e\n\n\nWhy Another ImageJ Launcher?\n----------------------------\nI needed to use Fji with the current versions of Java, version 11 and newer.\nThe original [ImageJ Launcher] works with Java 8, but not that well with the current versions,\nin particular not well on Mac with Arm64 processors (Apple Silicon).\nI attempted to fix the original [ImageJ Launcher source].\nThe source is burdened by technical debt,\nthe logic flow is too complex to correct without a significant rewrite.\n\n\nFeatures\n--------\n\nHere are the futures that are already implemented (see release notes for futures ofa specific release):\n\n* Uses similar options to the original ImageJ Launcher, so IJP Launcher can be used as a drop-in replacement\n* Intended to be used with Java 11 or newer (the original launcher can be used for Java 8)\n* Provides native executable for various OS/Hardware systems\n    - Windows\n    - Mac OS X Arm64 (Apple Silicon)\n    - Mac OS X Intel\n    - Linux\n* Selects location of the ImageJ directory\n    - Startup directory or\n    - Directory specified by `--ij-dir` command line option\n* Locates Java Virtual Machine for ImageJ:\n    - Use Java VM requested by the user (`--java-home`)\n    - Use `JAVA_HOME` environment variable\n    - Search ImageJ directory for available Java executables\n* Determines the amount of memory used by JVM based on total system memory use 75% of the max\n* Determines available `imagej-launcher*.jar`\n* **Performs updates** pending after the last time ImageJ was closed\n\nFull List of Command Line Options\n---------------------------------\n\n```\n  -h, --help          prints this usage text\n  --version           prints version\n  --dry-run           show the command line, but do not run anything\n  --info              informational output\n  --debug             verbose output\n  --java-home \u003cpath\u003e  specify JAVA_HOME explicitly\n  --ij-dir \u003cpath\u003e     set the ImageJ directory to \u003cpath\u003e (used to find jars/, plugins/ and macros/)\n```\n\nInstallation\n------------\nThe IJP ImageJ Launcher executables will be available on the [Releases] page.\n\n### Installing Fiji on Mac OS X Arm64\n\nThis example will show how to:\n\n* Download FIJI and unzip installation.\n* Download and install JVM for it.\n* Download the IJP ImageJ Launcher and use it to start Fiji\n\n**1. Download FIJI without JRE**\n\nGo to https://imagej.net/software/fiji/downloads and download the **\"No JRE\"** version (not specific to any OS).\nThat should get file called `fiji-nojre.zip`\n\n**2. Unzip the `fiji-nojre.zip` in a folder of choice**\n\nYou should get new app folder called `Fiji.app`.\n\"Right-click\" to show a popup menu and select \"Show Package Contents\" to see what is inside the `Fiji.app` folder.\nInside you should see folders and files like \"Contents\", \"db.xml.gz\", \"ImageJ-linux64\", ...\n\n**3. Create place for Java (JRE)**\n\nInside the `Fiji.app` folder create a new folder called `java`.\n\n**4. Download Java JRE or JDK**\n\nIn browser open https://adoptium.net/temurin/releases/\nSelect:\n\n* Operating System: `macOS`\n* Architecture: `aarch64` also known as Apple Silicon or Arm64\n* Package Type: `JRE` (`JDK` is fine too, is larger and supports Java compilation)\n* Version: `11-LTS` (`17-LTS` will work too, but you will not have JavaScript available, if you want to use it)\n\nClick on `tar.gz` button to download and save to the `java` folder you created earlier.\nYou should have file like `OpenJDK11U-jre_aarch64_mac_hotspot_11.0.20_8.tar.gz`.\n\n**5. Uncompress into the `Fiji.app/java` folder**\n\nThat will create folder like `jdk-11.0.20+8-jre`.\nThis is the Java VM that IJP ImageJ Launcher will use to start Fiji.\n\n**6. Download the IJP ImageJ Launcher and uncompress**\n\nGo to [Releases], download \"IJP-ImageJ-Launcher-0.2.0-macosx-arm64.zip\"\n\nUncompress \"IJP-ImageJ-Launcher-0.2.0-macosx-arm64.zip\".\nInside you will get `ImageJ-macosx`.\n\n**7. Add to Fiji.app**\n\nInside `Fiji.app` locate folder `Contents/MacOS`.\n\nCopy `ImageJ-macosx` to the `Contents/MacOS` folder, replacing `ImageJ-macosx` that was there.\n\n**8. Move Fiji.app to the Application folder**\n\nAt this point you can move the `Fiji.app` folder to the Applications folder and use is as a regular msOS application.\n\n**9. Troubleshooting**\n\nWhen you attempt to run Fiji with the new Launcher you may get a warning dialog\n![macOS_warning_dialog_01.png](assets%2FmacOS_warning_dialog_01.png)\n\nPossible work-around\n\n1. Delete `Fuji.app` folder\n2. Uncompressed `fiji-nojre.zip` to recreate `Fuji.app` folder, but do not make any changes to it yet. You may need to do it is different folder than before.\n3. Control-clock on `Fuji.app` and select \"Open\". You will see dialog saying \n    \"macOS cannot verify the developer of “Fiji”. Are you sure you want to open it?\"\n4. Click on \"Open\". You will see Fiji logo, but the application will close since it is not setup yet\n5. Now you can repeat steps \"3. Create place for Java (JRE)\" to \"7. Add to Fiji.app\" above\n\nIf you have problems installing, please report in [Discussions] or [Image.sc Forum]\n\n### Installing Fiji on Windows x64\n\nThis example will show how to:\n\n* Download FIJI and unzip installation.\n* Download and install JVM for it.\n* Download the IJP ImageJ Launcher and use it to start Fiji\n\n**1. Download FIJI without JRE**\n\nGo to https://imagej.net/software/fiji/downloads and download the **\"No JRE\"** version (not specific to any OS).\nThat should get file called `fiji-nojre.zip`\n\n**2. Unzip the `fiji-nojre.zip` in a folder of choice**\n\nYou should get new app folder called `Fiji.app`.\nInside you should see folders and files like \"Contents\", \"db.xml.gz\", \"ImageJ-linux64\", ...\n\n**3. Create place for Java (JRE)**\n\nInside the `Fiji.app` folder create a new folder called `java`.\n\n**4. Download Java JRE or JDK**\n\nIn browser open https://adoptium.net/temurin/releases/\nSelect:\n\n* Operating System: `Windows`\n* Architecture: `x64` also known as Apple Silicon or Arm64\n* Package Type: `JRE` (`JDK` is fine too, is larger and supports Java compilation)\n* Version: `11-LTS` (`17-LTS` will work too, but you will not have JavaScript available, if you want to use it)\n\nClick on `.zip` button to download and save to the `java` folder you created earlier.\nYou should have file like `OpenJDK11U-jre_x64_windows_hotspot_11.0.20_8.zip`.\n\n**5. Uncompress into the `Fiji.app/java` folder**\n\nThat will create folder like `jdk-11.0.20+8-jre`.\nThis is the Java VM that IJP ImageJ Launcher will use to start Fiji.\n\n**6. Download the IJP ImageJ Launcher to the Fiji.app directory**\n\nGo to [Releases], download \"IJP-ImageJ-Launcher-0.2.0-windows_x64.exe\", save it to the `Fiji.app` folder.\n\n**7. Start ImageJ**\n\nIn the `Fiji.app` folder double-click on `IJP-ImageJ-Launcher-0.2.0-windows_x64.exe`.\nThat should start Fiji.\n\nYou can also create a shortcut on the Desktop to avoid navigating to the `Fiji.app` folder each time.\n\n**_Left_**-click on the `IJP-ImageJ-Launcher-0.2.0-windows_x64.exe` and drag it to the Desktop.\nOnce you release mouse button, a pop-up manu will open, select \"Create shortcut here\".\nNow you can double-click on the new shortcut on the Desktop to start Fiji.\n\nYou can rename the Desktop alias to whatever you like, for instance, `Fiji`.\n\nIf you have problems installing, please report in [Discussions] or [Image.sc Forum]\n\n### Troubleshooting\n\n#### Start-up log `~/.ijp_imagej_launcher.log`\n\nThe IJP-ImageJ-Launcher writes diagnostic info to a file `.ijp_imagej_launcher.log` in the users home directory.\nThe information recorded is some as using `--debug` on command line.\n\n#### Starting from command prompt\n\nYou can start the IJP Image Launcher from the terminal and see diagnostic printouts that may help troubleshoot potential\nissues.\n\n1. Open the terminal (command prompt).\n2. Navigate to `Fiji.app` directory, for instance `cd ~/Download/Fiji.app`\n3. Run IJP ImageJ Launch typing: `./IJP-ImageJ-Launcher-0.1.0-macosx-arm64 --debug`\n\nYou should see diagnostic information about how the IJP ImageJ Launcher is attempting to start Fiji.\nThe error messages should help you to address the issue.\nPlease use [Discussions] or [Image.sc Forum] if you have additional questions.\n\nDeveloper Setup\n---------------\nInformation here is only applicable if you want to rebuild from sources.\n\nThe IJP ImageJ Launcher is written mostly in [Scala].\nWith about 10 lines of C code.\nNative binaries are created with help from [Scala Native].\n\nTo rebuild the IJP ImageJ Launcher from sources,\nyou need to setup Scala Native dependencies following instructions at [Scala Native].\nIn brief, you will need to install the following: JDK, SBT, and LLVM/CLang.\nDetails depend on OS.\nOn Windows you will also need Visual Studio 2019 (the Community Editions is sufficient).\nAfter requirements are installed, you should be able to build and run the launcher using command:\n\n```shell\nsbt run\n```\n\nYou can pass additional command line arguments, for instance `--help`:\n\n```shell\nsbt \"run --help\"\n```\n\nNotice the use of quotes.\n\n[Discussions]: https://github.com/ij-plugins/ijp-imagej-launcher/discussions\n\n[Fiji]: https://imagej.net/software/fiji/\n\n[Image.sc Forum]: https://forum.image.sc/tags/c/usage-issues/7/fiji\n\n[ImageJ 2]: https://imagej.net/software/imag\n\n[ImageJ Launcher]: https://imagej.net/learn/launcher\n\n[ImageJ Launcher source]: https://github.com/imagej/imagej-launcher/\n\n[Releases]: https://github.com/ij-plugins/ijp-imagej-launcher/releases\n\n[Scala]: https://www.scala-lang.org/\n\n[Scala Native]: https://scala-native.org/en/stable/","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fij-plugins%2Fijp-imagej-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fij-plugins%2Fijp-imagej-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fij-plugins%2Fijp-imagej-launcher/lists"}