{"id":34024764,"url":"https://github.com/electric-mass/arrangio","last_synced_at":"2026-05-25T20:37:42.770Z","repository":{"id":180099435,"uuid":"656775173","full_name":"electric-mass/arrangio","owner":"electric-mass","description":"Arranges a set of songs in groups with similar total play time.","archived":false,"fork":false,"pushed_at":"2024-10-04T10:53:54.000Z","size":94,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-15T06:46:49.886Z","etag":null,"topics":["knapsack","minimum-subset-sum-difference","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"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/electric-mass.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2023-06-21T15:58:28.000Z","updated_at":"2024-10-04T10:53:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"da2325e8-c8ca-41b5-b8ed-e76df8687969","html_url":"https://github.com/electric-mass/arrangio","commit_stats":null,"previous_names":["electric-mass/arrangio"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/electric-mass/arrangio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electric-mass%2Farrangio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electric-mass%2Farrangio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electric-mass%2Farrangio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electric-mass%2Farrangio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/electric-mass","download_url":"https://codeload.github.com/electric-mass/arrangio/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electric-mass%2Farrangio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33492976,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T14:31:05.219Z","status":"ssl_error","status_checked_at":"2026-05-25T14:31:02.878Z","response_time":57,"last_error":"SSL_read: 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":["knapsack","minimum-subset-sum-difference","python3"],"created_at":"2025-12-13T16:38:52.652Z","updated_at":"2026-05-25T20:37:42.765Z","avatar_url":"https://github.com/electric-mass.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# arrangio\n\nArranges a set of songs in groups with similar total play time.\n\n## Synopsis\n\nThis tool will try to arrange a set of songs into subsets of songs\n(groups) whose total play time will be the most sililar possible.\n\n## Prerequisites\n\nPython, version 3.8 or above, needs to be installed on your local\ncomputer.\n\n### Python 3.x\n\nPython version 3.8 or above is required for the tool to work. Python\nsetup can be found [here](https://www.python.org/downloads/).\n\n## Installation\n\nThe simplest way to install this tool is using pip:\n\n```shell\npip3 install arrangio\n```\n\n## Usage\n\nA simple example of how to use this tool:\n\n```shell\narrangio --groups 2 --song song01:3m24s --song song02:4m01s  --song song03:1m47s\n```\n\nList of all the options:\n\n```shell\nusage: arrangio [-h] [-g [NUM]] [-q] -s LABEL:HHhMMmSSs [LABEL:HHhMMmSSs ...] [-v]\n\noptions:\n  -h, --help            show this help message and exit\n  -g [NUM], --groups [NUM]\n                        number of groups to create (default: 2)\n  -q, --quiet           quiet mode (default: False)\n  -s LABEL:HHhMMmSSs [LABEL:HHhMMmSSs ...], --song LABEL:HHhMMmSSs [LABEL:HHhMMmSSs ...]\n                        song information (e.g.: song01:00h03m27s) (default: None)\n  -v, --version         show program's version number and exit\n```\n\n## Build (from source)\n\n[just](https://just.systems) is used to automate several steps of the\ndevelopment process.\n\nAll of the commands described bellow are to be executed on the root folder\nof this project.\n\nA development environment can be created using the following command:\n\n```shell\njust init\n```\n\nTo build a Python package for this library use the following command:\n\n```shell\njust build\n```\n\nAfter this you should have a wheel file (`*.whl`) inside a folder called\n`dist`.\n\nThe library can be install using the wheel file and pip3:\n\n```shell\npip3 --quiet install dist/arrangio-*.whl\n```\n\n## Contributing\n\n1. Fork it!\n2. Create your feature branch: `git checkout -b my-new-feature`\n3. Commit your changes: `git commit -am 'Add some feature'`\n4. Push to the branch: `git push origin my-new-feature`\n5. Submit a pull request\n\nPlease read the [CONTRIBUTING.md](https://github.com/electric-mass/arrangio/blob/master/CONTRIBUTING.md)\nfile for more details on how to contribute to this project.\n\n## Versioning\n\nThis project uses [SemVer](http://semver.org/) for versioning. For the versions\navailable, see the [tags on this repository](https://github.com/electric-mass/arrangio/tags).\n\n## Authors\n\n* **Frederico Martins** - [fscm](https://github.com/fscm)\n\nSee also the list of [contributors](https://github.com/electric-mass/arrangio/contributors)\nwho participated in this project.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/electric-mass/arrangio/blob/master/LICENSE)\nfile for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectric-mass%2Farrangio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felectric-mass%2Farrangio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectric-mass%2Farrangio/lists"}