{"id":19093449,"url":"https://github.com/imagej/example-bio-formats-legacy-plugin","last_synced_at":"2026-06-18T03:33:29.762Z","repository":{"id":137546307,"uuid":"107282858","full_name":"imagej/example-bio-formats-legacy-plugin","owner":"imagej","description":"Simple example of calling Bio-Formats with ImageJ 1.x + Java 6","archived":false,"fork":false,"pushed_at":"2017-10-17T15:58:13.000Z","size":5,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-02-22T07:51:28.850Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imagej.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2017-10-17T14:50:02.000Z","updated_at":"2023-10-19T20:09:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"a72e7dc6-f359-4fb1-9053-102dd18ea276","html_url":"https://github.com/imagej/example-bio-formats-legacy-plugin","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/imagej/example-bio-formats-legacy-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagej%2Fexample-bio-formats-legacy-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagej%2Fexample-bio-formats-legacy-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagej%2Fexample-bio-formats-legacy-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagej%2Fexample-bio-formats-legacy-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imagej","download_url":"https://codeload.github.com/imagej/example-bio-formats-legacy-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagej%2Fexample-bio-formats-legacy-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34475375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2024-11-09T03:24:43.313Z","updated_at":"2026-06-18T03:33:29.748Z","avatar_url":"https://github.com/imagej.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"This is an example Maven project implementing an ImageJ 1.x plugin\nthat calls the [Bio-Formats](https://imagej.net/Bio-Formats) library.\n\nIt was adapted from the\n[example-legacy-plugin project](https://github.com/imagej/example-legacy-plugin).\n\nIt is intended as a starting point to develop new ImageJ 1.x plugins\nin an IDE of your choice. You can even collaborate with developers using a\ndifferent IDE than you.\n\n* In [Eclipse](http://eclipse.org), for example, it is as simple as\n  _File\u0026gt;Import...\u0026gt;Existing Maven Project_.\n\n* In [NetBeans](http://netbeans.org), it is even simpler:\n  _File\u0026gt;Open Project_.\n\n* The same works in [IntelliJ](http://jetbrains.net).\n\n* If [jEdit](http://jedit.org) is your preferred IDE, you will need the\n  [Maven Plugin](http://plugins.jedit.org/plugins/?MavenPlugin).\n\nDie-hard command-line developers can use Maven directly by calling `mvn`\nin the project root.\n\nHowever you build the project, in the end you will have the `.jar` file\n(called *artifact* in Maven speak) in the `target/` subdirectory.\n\nTo copy the artifact into the correct place, you can call\n`mvn -Dimagej.app.directory=/path/to/ImageJ.app/`.\nThis will not only copy your artifact, but also all the dependencies. Restart\nyour ImageJ or call *Help\u003eRefresh Menus* to see your plugin in the menus.\n\nDeveloping plugins in an IDE is convenient, especially for debugging. To that\nend, the plugin contains a `main` method which starts ImageJ and runs the\nplugin. See also\n[this page](https://imagej.net/Debugging#Debugging_plugins_in_an_IDE_.28Netbeans.2C_IntelliJ.2C_Eclipse.2C_etc.29)\nfor information how ImageJ makes it easier to debug in IDEs.\n\nHow to use this project as a starting point\n===========================================\n\nEither\n\n* `git clone git://github.com/imagej/example-bio-formats-legacy-plugin`, or\n* unpack https://github.com/imagej/example-bio-formats-legacy-plugin/archive/master.zip\n\nThen:\n\n1. Edit the `pom.xml` file. Every entry should be pretty self-explanatory.\n   In particular, change\n    1. the *artifactId* (**NOTE**: should contain a '_' character)\n    2. the *groupId*, ideally to a reverse domain name your organization owns\n    3. the *version* (note that you typically want to use a version number\n       ending in *-SNAPSHOT* to mark it as a work in progress rather than a\n       final version)\n    4. the *dependencies* (read how to specify the correct\n       *groupId/artifactId/version* triplet\n       [here](https://imagej.net/Maven#How_to_find_a_dependency.27s_groupId.2FartifactId.2Fversion_.28GAV.29.3F))\n    5. the *developer* information\n    6. the *scm* information\n2. Remove the `Simple_Read.java` file and add your own `.java` files\n   to `src/main/java/\u003cpackage\u003e/` (if you need supporting files -- like icons\n   -- in the resulting `.jar` file, put them into `src/main/resources/`)\n3. Edit `src/main/resources/plugins.config`\n4. Replace the contents of `README.md` with information about your project.\n\nIf you cloned the `example-bio-formats-legacy-plugin` repository, you probably\nwant to publish the result in your own repository:\n\n1. Call `git status` to verify .gitignore lists all the files (or file\n   patterns) that should be ignored\n2. Call `git add .` and `git add -u` to stage the current files for\n   commit\n3. Call `git commit` or `git gui` to commit the changes\n4. [Create a new GitHub repository](https://github.com/new)\n5. `git remote set-url origin git@github.com:\u003cusername\u003e/\u003cprojectname\u003e`\n6. `git push origin HEAD`\n\n### Eclipse: To ensure that Maven copies the plugin to your ImageJ folder\n\n1. Go to _Run Configurations..._\n2. Choose _Maven Build_\n3. Add the following parameter:\n    - name: `imagej.app.directory`\n    - value: `/path/to/ImageJ.app/`\n\nThis ensures that the final `.jar` file will also be copied to your ImageJ\nplugins folder everytime you run the Maven Build\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagej%2Fexample-bio-formats-legacy-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimagej%2Fexample-bio-formats-legacy-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagej%2Fexample-bio-formats-legacy-plugin/lists"}