{"id":18058792,"url":"https://github.com/hiulit/es-theme-extras","last_synced_at":"2025-04-05T11:26:15.391Z","repository":{"id":72426540,"uuid":"105365354","full_name":"hiulit/es-theme-extras","owner":"hiulit","description":"Script for RetroPie to install some extras for EmulationStation themes (icons, splashscreens and launching images)","archived":false,"fork":false,"pushed_at":"2017-11-07T14:41:02.000Z","size":194,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-10T22:29:33.308Z","etag":null,"topics":["emulationstation","retropie","script","themes"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/hiulit.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}},"created_at":"2017-09-30T11:27:37.000Z","updated_at":"2023-09-08T17:30:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"dcaa097f-08ca-4bdd-aef3-e817f5b451df","html_url":"https://github.com/hiulit/es-theme-extras","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiulit%2Fes-theme-extras","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiulit%2Fes-theme-extras/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiulit%2Fes-theme-extras/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiulit%2Fes-theme-extras/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hiulit","download_url":"https://codeload.github.com/hiulit/es-theme-extras/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247327855,"owners_count":20921106,"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":["emulationstation","retropie","script","themes"],"created_at":"2024-10-31T03:09:09.793Z","updated_at":"2025-04-05T11:26:15.353Z","avatar_url":"https://github.com/hiulit.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Extras for RetroPie themes\n\n\u003e This is my first shell script ever, so there are surely code errors. [Contributing](#contributing) is most welcomed.\n\nThis script let's you install some extras for RetroPie themes. These extras are:\n\n* [x] Icons\n* [x] Splashscreens\n* [x] Launching images\n\n![Install Pixel](example-images/example-01.jpg \"Install Pixel\")\n![Update or Uninstall Pixel](example-images/example-02.jpg \"Update or Uninstall Pixel\")\n![Extras](example-images/example-03.jpg \"Extras\")\n![Install Pixel icons](example-images/example-04.jpg \"Install Pixel icons\")\n![Install Pixel splashscreen](example-images/example-05.jpg \"Install Pixel splashscreen\")\n![Choose splashscreen](example-images/example-06.jpg \"Choose splashscreen\")\n![Install Pixel launching images](example-images/example-07.jpg \"Install Pixel launching images\")\n\n## Installation\n\n```\ncd /home/pi/\ngit clone https://github.com/hiulit/es-theme-extras.git\ncd es-theme-extras/\nsudo chmod +x es-theme-extras.sh\nsudo ./es-theme-extras.sh\n```\n\n## The big issue\n\nAt this moment, [Pixel](https://github.com/ehettervik/es-theme-pixel) is the only theme that works with this script because it's the only one (that I know of) that has [icons](https://github.com/ehettervik/es-theme-pixel/tree/master/retropie/icons), splashscreens ([16:9](https://github.com/ehettervik/es-theme-pixel/blob/master/splash16-9.png) and [4:3](https://github.com/ehettervik/es-theme-pixel/blob/master/splash4-3.png)) and [launching images](https://github.com/ehettervik/es-runcommand-splash).\n\nPixel theme has both icons and splashscreens in the same repository and launching images has its own repository.\n\nThis script is created under these premises:\n\n* Icons and splashscreens must be in the same repository `https://github.com/USERNAME/es-theme-THEME`.\n* Icons must be in path `/retropie/icons`.\n* Splashscreens must be in the root path and named `splash16-9.png` and/or `splash4-3.png`.\n* Launching images must be in another repository `https://github.com/USERNAME/es-runcommand-splash`.\n\nI think that could be **standarized** so that every theme could take advantage of this script.\n\n## Proposal for standarization\n\nI propose two versions:\n\n* [Self-contained](#self-contained-same-repository-version) (all extras in the same repository).\n* [Diferent repositories](#diferent-repositories-version) for each extra (icons, splashscreens and launching images).\n\nWhen the decision is made, I'll make the necessary changes according to the version agreed upon.\n\n### Self-contained (same repository) version\n\n* **Theme URL**: `https://github.com/USERNAME/es-theme-THEME`\n* **Icons URL**: `https://github.com/USERNAME/es-theme-THEME/retropie/icons`\n* **Splashscreens URL**: `https://github.com/USERNAME/es-theme-THEME/retropie/splashscreens`\n* **Launching images URL**: `https://github.com/USERNAME/es-theme-THEME/retropie/launching-images`\n\n### Diferent repositories version\n\n* **Theme URL**: `https://github.com/USERNAME/es-theme-THEME`\n* **Icons URL**: `https://github.com/USERNAME/es-theme-THEME-icons`\n* **Splashscreens URL**: `https://github.com/USERNAME/es-theme-THEME-splashscreens`\n* **Launching images URL**: `https://github.com/USERNAME/es-theme-THEME-launching-images`\n\nWhere **USERNAME** is GitHub's username and **THEME** is the theme's name.\n\n## Filetype, naming convention and formatting\n\nIn both cases the filetype, naming convention and formatting must be the same, as follows:\n\n* [Icons](#icons)\n* [Splashscreens](#splashscreens)\n* [Launching images](#launching-images)\n\n### Icons\n\n#### Filetype\n\n* Icons must be `.png` filetype\n\n#### Naming conventions\n\nNames must be the same as RetroPie's default icons:\n\n* audiosettings.png\n* bluetooth.png\n* configedit.png\n* esthemes.png\n* filemanager.png\n* raspiconfig.png\n* retroarch.png\n* retronetplay.png\n* rpsetup.png\n* runcommand.png\n* showip.png\n* splashscreen.png\n* wifi.png\n\nSee https://github.com/RetroPie/RetroPie-Setup/tree/master/scriptmodules/supplementary/retropiemenu/icons\n\n#### Formatting\n\nSame as RetroPie's default icons:\n\n* Names must be all lowercase\n* No spaces\n\nSee https://github.com/RetroPie/RetroPie-Setup/tree/master/scriptmodules/supplementary/retropiemenu/icons\n\n### Splashscreens\n\n#### Filetype\n\n* Image splashscreens must be `.png` filetype\n* Video splashscreens must be `.mp4` filetype\n\n#### Naming conventions\n\n#### Images\n\n* `THEME`-`splashscreen`-`16-9.png`\n\ne.g `pixel-splashscreen-16-9.png`\n\n* `THEME`-`splashscreen`-`4-3.png`\n\ne.g `pixel-splashscreen-4-3.png`\n\n#### Videos\n\n* `THEME`-`splashscreen`-`video.mp4`\n\ne.g `pixel-splashscreen-video.mp4`\n\n#### Formatting\n\n* Names must be all lowercase\n* Spaces must be hyphens\n\n### Launching images\n\n#### Filetype\n\nLaunching images must be `.png` or `.jpg` filetype\n\n#### Naming conventions\n\n* `SYSTEM_NAME/launching.png`\n\ne.g. `nes/launching.png`\n\nSee https://github.com/ehettervik/es-runcommand-splash\n\n#### Formatting\n\n* Names must be all lowercase\n* No spaces\n\n## Changelog\n\n### v0.1.1 (November 7th 2017)\n\n* Fixed backtitle.\n* Removed comments.\n* Fixed `git pull` when theme needs an update.\n\n### v0.1.0 (October 5th 2017)\n\n* Initial commit\n\n## Contributing\n\nFirst of all, I really appreciate that you're willing to ~~waste~~ spend some time contributing to **es-theme-extras**! 🎉👍\n\nYou can help make **es-theme-extras** better by [reporting issues](#issues) or [contributing code](#pull-requests).\n\n### Issues\n\n[Issues](https://github.com/hiulit/es-theme-extras/issues) can be used not only for bug reporting, but also for suggesting improvements, whether they are code related (cleaner code, modularity, etc.) or feature requests.\n\n#### Guidelines\n\n* Search [previous issues](https://github.com/hiulit/es-theme-extras/issues?utf8=%E2%9C%93\u0026q=is%3Aissue) before creating a new one, as yours may be a duplicate.\n* Use a clear and descriptive title for the issue to identify the problem.\n* Describe the exact steps which reproduce the problem in as many details as possible.\n\n### Pull requests\n\n[Pull requests](https://help.github.com/articles/creating-a-pull-request/) are most welcomed! 😃\n\n* Fork **es-theme-extras**: `git clone git@github.com:your-username/es-theme-extras.git`.\n* Create a **new branch** and make the desired changes there.\n* [Create a pull request](https://github.com/hiulit/es-theme-extras/pulls).\n\n## Authors\n\nMe 😛 [@hiulit](https://github.com/hiulit).\n\n## Credits\n\nFiletype, naming conventions and formatting taken (partially and revisited) from [retropie-splashscreens-extra repository by HerbFargus](https://github.com/HerbFargus/retropie-splashscreens-extra/blob/master/README.md)\n\n## License\n\nMIT License\n\nCopyright (c) 2017 Xavier Gómez Gosálbez\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiulit%2Fes-theme-extras","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhiulit%2Fes-theme-extras","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiulit%2Fes-theme-extras/lists"}