{"id":14384318,"url":"https://github.com/adnodev/adno","last_synced_at":"2026-01-21T11:31:03.521Z","repository":{"id":153607643,"uuid":"577391358","full_name":"adnodev/adno","owner":"adnodev","description":"adno.app. The ADNO source code. adno.app. Adno is a web application for viewing, editing and sharing narratives and pathways on static images and IIIF images.","archived":false,"fork":false,"pushed_at":"2025-12-19T16:22:23.000Z","size":3152,"stargazers_count":29,"open_issues_count":2,"forks_count":6,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-12-21T05:05:40.756Z","etag":null,"topics":["iiif","image"],"latest_commit_sha":null,"homepage":"https://adno.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adnodev.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-12-12T16:24:17.000Z","updated_at":"2025-12-19T15:52:27.000Z","dependencies_parsed_at":"2024-06-11T23:45:22.042Z","dependency_job_id":"43b90693-816a-4f06-b650-e067c040602b","html_url":"https://github.com/adnodev/adno","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/adnodev/adno","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adnodev%2Fadno","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adnodev%2Fadno/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adnodev%2Fadno/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adnodev%2Fadno/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adnodev","download_url":"https://codeload.github.com/adnodev/adno/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adnodev%2Fadno/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28632771,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T04:47:28.174Z","status":"ssl_error","status_checked_at":"2026-01-21T04:47:22.943Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["iiif","image"],"created_at":"2024-08-28T18:01:18.352Z","updated_at":"2026-01-21T11:31:03.516Z","avatar_url":"https://github.com/adnodev.png","language":"JavaScript","readme":"# Adno\n\nAdno is a web application for viewing, editing and sharing narratives and pathways on static images and IIIF images.\n\nAdno has 2 available versions : a [Full version](https://w.adno.app) including the Editor and Viewer and the [Light](https://r.adno.app) one including only the Viewer.\n\n## Table of Contents\n\n1. [How to start](#how-to-start-with-adno-)\n2. [Host Adno](#host-adno-with-github-pages)\n3. [IIIF EXAMPLES](#iiif-pictures-examples)\n4. [QUICKSTART](#quickstart-with-IIIF-pictures-examples)\n5. [Developpers section](#for-developpers)\n6. [Keyboard shortcuts](#shortcuts-for-the-viewer)\n7. [IPFS support](#ipfs-support)\n8. [Translation](#translation)\n\n## How to start with Adno ?\n\nFirst, go to [Adno's repository](https://github.com/adnodev/adno/releases) and download the version you would like to use (FULL or LIGHT). \n\nThen, if you want to use it locally you have to use a web server.\n\n- Unzip the package and go inside the directory.\n- Create a light web server using `python -m http.server 8080`or `php -S localhost:8080` command to run a web server on the port 8080.\n- Use localhost:8080 URL in your browser.\n\nOn the web, unzip the Adno package to your web server and start it.\n\nEnjoy using Adno !\n\n## Host Adno with your Github Pages\n\nIt's the simplest way to deploy your own Adno on the Web.\n\n- Fork Adno repo repository.\n- Copy the file `.env.example` to `.env` and adjust it's content. \n- Select this new repository and click on the `Settings` tab.\n- Select the tab `Pages` on the left panel. \n- Then, you’ll have to select the source of build en deployement : `Github Actions`.\n- On the top menu click on the `Actions` tab and click on the green button “I understand my workflows, go ahead and enable them”.\n- On the left panel, select the tab “ADNO BUILD FULL” or “ADNO BUILD LIGHT” depending of `.env`content.\n- Click on `Run workflow` (Branch:main).\n- Return to “Settings” then “Pages”, click on `Visit site` button.\n\nEnjoy using Adno !\n\n## IIIF pictures examples\n\n* https://ronallo.com/iiif-workshop/presentation/example-manifests.html\n* https://free.iiifhosting.com/iiif/1c8d49343676a04fffcd92979c02e9394e48bac96f590fffbadffc9133cd06b9/info.json\n* https://iiif.emf.fr/iiif/3/peutinger.jp2/info.json\n* https://iiif.emf.fr/iiif/3/saint-savin.jpg/info.json\n\n## Quickstart with IIIF pictures examples\n\n* https://w.adno.app/#/search?url=https://free.iiifhosting.com/iiif/1c8d49343676a04fffcd92979c02e9394e48bac96f590fffbadffc9133cd06b9/info.json\n* https://w.adno.app/#/search?url=https://iiif.emf.fr/iiif/3/peutinger.jp2/info.json\n* https://w.adno.app/#/search?url=https://iiif.emf.fr/iiif/3/saint-savin.jpg/info.json\n\n## Licence\n\n[LICENCE](https://github.com/adnodev/adno/blob/main/LICENCE)\n\n## For developpers\n\nIf you want to contribute to Adno here are few steps to start \n\n  * clone the project from github (https://github.com/adnodev/adno.git)\n  * Start the project with the following command : **yarn start**\n    * Create a .env file and put the version you would like (examples below)\n    * run **yarn build-full** to build full-version and **yarn build-light** to build the light version.\n  * In case of errors try to remove node_modules folder, .parcel-cache and yarn.lock file and reinstall module with **yarn install** command.\n\n### Customize your own Adno\n\nCreate a .env file and insert the following properties as you wish :\n\n```\n# MODE \nADNO_MODE=FULL\n\n# MATOMO\nMATOMO_SITE_ID=YOUR SITE ID HERE\nMATOMO_URL=YOUR OWN MATOMO URL\n\n# WEBSITE PROPERTIES\nADNO_TITLE=YOUR OWN TITLE\n\n# FOOTER\nADNO_FOOTER=TRUE\nADNO_FOOTER_TEXT=YOUR FOOTER TEXT HERE\n\n# GRANTED IMAGES EXTENSIONS\nGRANTED_IMG_EXTENSIONS=jpg,png,JPG,PNG\n\n# CORS SERVER\nCORS_SERVER=https://app-f1586530-d9cb-472f-93fd-e586b0a801ab.cleverapps.io\n```\n\n### Build Adno\n\n.env.ADNOFULL example :\n\n```\n# MODE \nADNO_MODE=FULL\n\n# FOOTER\nADNO_FOOTER=TRUE\n\n# GRANTED IMAGES EXTENSIONS\nGRANTED_IMG_EXTENSIONS=jpg,png,JPG,PNG\n\n# CORS SERVER\nCORS_SERVER=https://app-f1586530-d9cb-472f-93fd-e586b0a801ab.cleverapps.io\n```\n\n.env.ADNOLIGHT example :\n\n```\n# MODE \nADNO_MODE=LIGHT\n\n# FOOTER\nADNO_FOOTER=TRUE\n\n# GRANTED IMAGES EXTENSIONS\nGRANTED_IMG_EXTENSIONS=jpg,png,JPG,PNG\n\n# CORS SERVER\nCORS_SERVER=https://app-f1586530-d9cb-472f-93fd-e586b0a801ab.cleverapps.io\n```\n\nBuild both versions :\n\nWarning : this action requires .env.ADNOFULL and .env.ADNOLIGHT files !\n\nRun **yarn build** in your terminal, it will run both commands **build-full** and **build-light**\n\n## Adno embedded in your website\n\nAvailable settings for the embed :\n\n- delay with `min = 1` and `max = 20` (default 3 seconds)\n- navigator value = `true` or `false`\n- toolbar value = `true` or `false`\n- toolbarsfs value = `true` or `false`\n- startfirst value = `true` or `false`\n- should_auto_play_annotations value = `true` or `false`\n- rotation value = `true` or `false`\n- anno_bounds value = `true` or `false`\n- show_outlines value = `true` or `false`\n- show_eyes value = `true` or `false`\n- sound_mode value = `no_sound` or `spatialization` or `no_spatialization`\n- show_only_current_annotation = `true` or `false` (default false)\n\nExample : https://w.adno.app/#/embed?url=https://static.emf.fr/adno/annotations.json\u0026delay=1\u0026rotation=false\u0026anno_bounds=true\u0026show_outlines=true\n\nA little example with an iframe that you can insert in your own projects :\n\n```\n    \u003ciframe src=\"https://w.adno.app/#/embed?url=https://static.emf.fr/adno/annotations.json\u0026delay=1\u0026rotation=false\u0026anno_bounds=true\" height=\"500\" width=\"1200\" allowfullscreen=\"true\"\u003e\u003c/iframe\u003e\n\n```\n\n## Shortcuts for the viewer \n\n- Key 'P' to start the autoplay\n- Key 'E' to toggle FullScreen\n- Key 'S' to toggle annotation bounds\n- Key 'T' to toggle the toolsbar\n- Arrows (left and right) to change the current selected annotation\n\n## IPFS support\n\nAdd the following environment variable to use an IPFS gateway\n\n```\n# IPFS SUPPORT\nIPFS_GATEWAY=https://ipfs.io/ipfs/\n```\n\n## Translation\n\nIf Adno is not available in the language of your choice, you can contribute by adding a new language and proposing translations on the Adno section of the [Weblate platform](https://hosted.weblate.org/projects/adno/). In the same way, you can propose changes and corrections to existing translations.\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadnodev%2Fadno","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadnodev%2Fadno","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadnodev%2Fadno/lists"}