{"id":22173485,"url":"https://github.com/jlumbroso/incipit","last_synced_at":"2025-07-26T15:31:37.003Z","repository":{"id":47751580,"uuid":"345198111","full_name":"jlumbroso/incipit","owner":"jlumbroso","description":"CLI and Python package to extract systems of staves from musical scores. 🎼 🎶","archived":false,"fork":false,"pushed_at":"2021-08-25T04:08:34.000Z","size":12702,"stargazers_count":8,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-08-31T17:50:11.255Z","etag":null,"topics":["command-line-tool","image-processing","musical-scores","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jlumbroso.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-06T21:22:59.000Z","updated_at":"2024-05-15T09:53:24.000Z","dependencies_parsed_at":"2022-08-27T21:21:39.024Z","dependency_job_id":null,"html_url":"https://github.com/jlumbroso/incipit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlumbroso%2Fincipit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlumbroso%2Fincipit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlumbroso%2Fincipit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlumbroso%2Fincipit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jlumbroso","download_url":"https://codeload.github.com/jlumbroso/incipit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227690974,"owners_count":17805018,"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":["command-line-tool","image-processing","musical-scores","python"],"created_at":"2024-12-02T07:33:43.231Z","updated_at":"2024-12-02T07:33:43.924Z","avatar_url":"https://github.com/jlumbroso.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `incipit` — extract systems of staves from musical scores\n\nThis command-line tool (and Python package) allows for the easy extraction of\nsystems of staves from musical scores. In particular, it makes it easy to extract\nthe first system of any musical score that is in B\u0026W format, and has a noiseless\nenough background\n\nThis tool was built to automatically generate incipits for large sets of scores,\nlike those downloaded from IMSLP. It was specifically built to create an index\nof the 555 keyboard sonatas by Domenico Scarlatti, in a related project.\n\n## Installation\n\nThe package is available on PyPI as `incipit` and so is available the usual way, i.e.,\n```\nsudo pip install incipit\n```\nIn addition to the Python package, this should also install a CLI binary that is\nrunnable, called `incipit`.\n\n## Usage\n\n```\nUsage: incipit [OPTIONS] INPUT\n\n  Extract the first (or any) system of staves from a black-and-white modern\n  musical score, either available as an image file or PDF. For instance,\n\n      $ incipit -o \"555-incipit.png\" ./input/pdf/555-gilbert.pdf\n\n  will extract the first system of staves of the sheet music\n  `555-gilbert.pdf' as the image `555-incipit.png`. And,\n\n      $ incipit --output \"1__{}.png\" -# '0,-1' ./input/pdf/1-gilbert.pdf\n\n  will extract the first and last systems of staves of `1-gilbert.pdf` and\n  output these as the images `1__0.png' (first system) and `1__10.png' (last\n  system).\n\nOptions:\n  -a, --audit                   Visualize system detection across document\n  -c, --count                   Output number of detected systems\n  -p, --pages TEXT              List of pages to process (e.g., '0', '0,-1')\n  -#, --systems TEXT            List of systems to extract (e.g., '0', '0,-1')\n  -h, --height-threshold FLOAT  % of height threshold for system detection\n  -w, --width-threshold FLOAT   % of width threshold for system detection\n  -o, --output TEXT             Output file pattern\n  -v, --verbose                 Print debug information\n  --version                     Show the version and exit.\n  --help                        Show this message and exit.\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlumbroso%2Fincipit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjlumbroso%2Fincipit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlumbroso%2Fincipit/lists"}