{"id":42500590,"url":"https://github.com/ips-lmu/octra","last_synced_at":"2026-04-28T13:01:28.886Z","repository":{"id":24916254,"uuid":"82665211","full_name":"IPS-LMU/octra","owner":"IPS-LMU","description":"OCTRA is a web-application for the orthographic transcription of audio files.","archived":false,"fork":false,"pushed_at":"2026-04-15T14:54:10.000Z","size":55605,"stargazers_count":39,"open_issues_count":2,"forks_count":9,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-04-15T16:40:28.586Z","etag":null,"topics":["annotation-tool","audio-transcribing","transcription","transcription-tool","webapplication"],"latest_commit_sha":null,"homepage":"https://clarin.phonetik.uni-muenchen.de/apps/octra/","language":"TypeScript","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/IPS-LMU.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-02-21T10:08:20.000Z","updated_at":"2026-04-15T14:53:12.000Z","dependencies_parsed_at":"2024-01-26T17:49:00.849Z","dependency_job_id":"ab792882-5a0b-4f1f-9f2c-414827d9949f","html_url":"https://github.com/IPS-LMU/octra","commit_stats":{"total_commits":1900,"total_committers":6,"mean_commits":316.6666666666667,"dds":"0.26473684210526316","last_synced_commit":"7323ca093647c6ef84573ab7917ecb7927cab70d"},"previous_names":[],"tags_count":137,"template":false,"template_full_name":null,"purl":"pkg:github/IPS-LMU/octra","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IPS-LMU%2Foctra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IPS-LMU%2Foctra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IPS-LMU%2Foctra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IPS-LMU%2Foctra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IPS-LMU","download_url":"https://codeload.github.com/IPS-LMU/octra/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IPS-LMU%2Foctra/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32381696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T11:25:28.583Z","status":"ssl_error","status_checked_at":"2026-04-28T11:25:05.435Z","response_time":56,"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":["annotation-tool","audio-transcribing","transcription","transcription-tool","webapplication"],"created_at":"2026-01-28T13:05:22.893Z","updated_at":"2026-04-28T13:01:28.877Z","avatar_url":"https://github.com/IPS-LMU.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eOCTRA 2.0.0\u003c/h1\u003e\n\n\u003cdiv align=\"center\" style=\"background-color:#e5efe5;\"\u003e\n  \u003cimg src=\"apps/octra/src/assets/img/socialmedia/Octra2_thumbnail_github.png\"/\u003e\n  \u003cp style=\"color:black;\"\u003e\n    Octra is a web-application for the \u003cb\u003eo\u003c/b\u003erthographi\u003cb\u003ec\u003c/b\u003e \u003cb\u003etra\u003c/b\u003enscription of audiofiles. It allows you to transcribe your files from the computer or from a project created by the octra-backend software we are currently working at.\n  \u003c/p\u003e\n  \u003cp style=\"padding-bottom:20px;\"\u003e\n  \u003cimg style=\"margin:3px;border:1px solid lightgray;\" width=\"215\" height=\"250\" src=\"https://clarin.phonetik.uni-muenchen.de/apps/octra/contents/1.3/img/features/editor3_1.png\" alt=\"2D-Editor\"\u003e\n  \u003cimg style=\"margin:3px;border:1px solid lightgray;\" width=\"215\" height=\"250\" src=\"https://clarin.phonetik.uni-muenchen.de/apps/octra/contents/1.3/img/features/editor3_2.png\" alt=\"2D-Editor\"\u003e\n  \u003cimg style=\"margin:3px;border:1px solid lightgray;\" width=\"215\" height=\"250\" src=\"https://clarin.phonetik.uni-muenchen.de/apps/octra/contents/1.3/img/features/editor2.png\" alt=\"Linear Editor\"\u003e\n  \u003cimg style=\"margin:3px;border:1px solid lightgray;\" width=\"215\" height=\"250\" src=\"https://clarin.phonetik.uni-muenchen.de/apps/octra/contents/1.3/img/features/editor1.png\" alt=\"Dictaphone Editor\"\u003e\n  \u003cimg style=\"margin:3px;border:1px solid lightgray;\" width=\"215\" height=\"250\" src=\"https://clarin.phonetik.uni-muenchen.de/apps/octra/contents/1.3/img/features/overview.png\" alt=\"Linear Editor\"\u003e\n  \u003cimg style=\"margin:3px;border:1px solid lightgray;\" width=\"215\" height=\"250\" src=\"https://clarin.phonetik.uni-muenchen.de/apps/octra/contents/1.3/img/features/export.png\" alt=\"Dictaphone Editor\"\u003e\n  \u003cbr/\u003e\n  \u003ca href=\"https://clarin.phonetik.uni-muenchen.de/apps/octra/octra/features\" style=\"font-weight:bold;\"\u003e\n\u003cbr/\u003e\n    More information\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n\u003c/div\u003e\n\u003c/div\u003e\n\n## Editors:\n\nOctra supports different editors that you can choose according to your preferences. You can also switch between these easily while you are working on the same task.\n\n* 2D-Editor: This editor breaks the whole view of the signal to pieces and shows the pieces as lines one after one. Here you can set boundaries und define segments too.\n* Dictaphone Editor: An typical, easy-to-use editor with just a texteditor and an audioplayer.\n* Linear-Editor: This editor shows two signaldisplays: One for the whole view of the signal and one as loupe. You can set boundaries and define segments.\n\n## User Manual\n\nYou can find the manual for users here: [OCTRA Manual](https://clarin.phonetik.uni-muenchen.de/apps/octra/manuals/octra/)\n\n## Features\n\n* Three different editors\n* NEW: Online Mode powered by Octra-Backend\n* Noise markers (placeholders) in the form of icons in text. Icons can be UTF-8 symbols, too.\n* Auto-saving of the transcription progress to prevent data loss\n* Import/Export support for various file formats like AnnotJSON, Textgrid, Text, Table and more.\n* Validation using project specific guidelines. **New: text editor supports inline validation **\n* Shortcuts for faster transcriptions\n* Multi-Tiers support in local mode\n* Logging of user activities for further studies\n* Localization of the GUI\n* Customization with configuration files for the app, project, guidelines and validation methods.\n* Segment boundaries as markers in text\n* Overview window to see the whole transcript\n* Cutting audio files up to 300 MB\n* Visible transcripts in 2D-Editor\n* Costom table generator\n* ASR support for transcription and segmentation\n* NEW: Each mode saves its own application state to the browser\n* NEW: Redo \u0026 Undo for signal displays\n\n## Remarks\n\nAt the moment, OCTRA's online mode supports only one specific server database. That means, if you install OCTRA on your server, you can only use the local mode. We are working on supporting other servers (project \"octra-backend\" is in development).\n\n## Libraries\n\nThe libraries are still in development. If you want to use them you find more information [here](libs/README.md).\n\n## Production Use\n\n### OCTRA website\n\nIf you don't want to install OCTRA, you can use the latest release [here](https://clarin.phonetik.uni-muenchen.de/apps/octra/octra/).\n\n### Installation\n\nIn a production environment you don't need to compile OCTRA again.\n\n1. Download the latest release from the [releases page](https://github.com/IPS-LMU/octra/releases).\n\n2. Extract and Copy its content to your http-server. If you have already installed an older version of OCTRA, please notice to not override the old config folder. More information about upgrading can be found in the next section.\n\n3. Before you can use OCTRA, duplicate and rename the `appconfig_sample.json` to `appconfig.json` in the config folder. Please make sure, that you offer all translation files for any language you defined in config.json.\n\n4. To make OCTRA work please change the 'database:name' entry in your appconfig.json. After the first launch a new local database with this name will be created.\n\n5. Please have a look on the projectconfig.json in the localmode folder. In this file you can change the settings of the local mode.\n\n6. Change the baseref attribute in the index.html according to the url where your OCTRA installation is hosted.\n\n7. Test if OCTRA works and check the webconsole if all works fine. If there are no errors you can use OCTRA.\n\n### Upgrade\n\n1. Duplicate and rename your octra directory (e.g. to 'octra_backup') on your server.\n\n2. Download the new OCTRA release and upload the 'dist' folder to your server next to the backup and rename it to the same name like before (e.g. 'octra').\n\n3. Copy your old appconfig.json and localmode folder to the new config directory.\n\n4. Compare your appconfig.json with the new appconfig_samples.json file. If there are new entries, just copy and paste them to your appconfig.\n\n5. Compare your projectconfig.json file with the new projectconfig.json file in the localmode folder.\n\n6. Change the baseref attribute in the index.html according to the url where your OCTRA installation is hosted.\n\n7. Test if OCTRA works and check the webconsole if all works fine. If there are no errors you can use OCTRA.\n\n## Development Use\n\nOn the Development level OCTRA requires Node 6.9.0 or higher, together with NPM 3 or higher.\n\nThen you can install OCTRA:\n\n1. Clone the octra repository.\n2. Go to the octra directory via Terminal (or GitBash on Windows).\n3. Call `` npm install ``.\n4. Wait.\n5. Duplicate the file ``src/config/appconfig_sample.json`` and rename it to ``scr/config/appconfig.json``. In appconfig.json you can change the settings of your instance of OCTRA.\n6. After the installation you can call `` npm start `` to start the node server.\n7. After that please read the notice about the config files in the production use section\n\n## Documentation\n\n* For users: [OCTRA manual](https://clarin.phonetik.uni-muenchen.de/apps/octra/manual/1.3.0/)\n* For project leaders/administrators: [Github Wiki](https://github.com/IPS-LMU/octra/wiki).\n\n## Contribution\n\n### Commit template\n\nFor this project \u003ca href=\"https://github.com/commitizen/cz-cli\"\u003ecommitizen\u003c/a\u003e is used. If you want to contribute to this project you should make use of this tool to create commit messages important for the changelog (other commit messages will be ignored otherwise). For WebStorm or PHPStorm there is a \u003ca href=\"https://plugins.jetbrains.com/plugin/9861-git-commit-template\"\u003eCommit Template Plugin\u003c/a\u003e to create these templates.\n\nFor creating changelog automatically, \u003ca href=\"https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-cli\"\u003econventional-changelog-cli\u003c/a\u003e is used. To create changelogs you need to install conventional-changelog-cli globally as described on its github page. After installation you just need to run `npm run changelog` to create the changelog automatically.\n\n### Translation\n\nTo translate OCTRA to a new language please visit https://clarin.phonetik.uni-muenchen.de/apps/octra/translation/start.php\n\nIf the language you would like translate to does not exist please send us an email to octra@phonetik.uni-muenchen.de\n\n### Affiliations\n\n[INSTITUTE OF PHONETICS AND SPEECH PROCESSING](http://www.en.phonetik.uni-muenchen.de/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fips-lmu%2Foctra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fips-lmu%2Foctra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fips-lmu%2Foctra/lists"}