{"id":13597533,"url":"https://github.com/YACReader/yacreader","last_synced_at":"2025-04-10T01:30:54.949Z","repository":{"id":41057247,"uuid":"131334717","full_name":"YACReader/yacreader","owner":"YACReader","description":"This repo contains the code of YACReader's desktop version.","archived":false,"fork":false,"pushed_at":"2025-03-29T10:32:08.000Z","size":51124,"stargazers_count":1064,"open_issues_count":158,"forks_count":97,"subscribers_count":22,"default_branch":"develop","last_synced_at":"2025-03-29T11:28:53.564Z","etag":null,"topics":["hacktoberfest","hacktoberfest2022"],"latest_commit_sha":null,"homepage":"https://www.yacreader.com","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YACReader.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING.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}},"created_at":"2018-04-27T19:01:53.000Z","updated_at":"2025-03-24T11:06:08.000Z","dependencies_parsed_at":"2024-01-19T16:55:40.806Z","dependency_job_id":"367549bf-5b31-4a1e-ae9e-8a23ea75b94b","html_url":"https://github.com/YACReader/yacreader","commit_stats":null,"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YACReader%2Fyacreader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YACReader%2Fyacreader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YACReader%2Fyacreader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YACReader%2Fyacreader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YACReader","download_url":"https://codeload.github.com/YACReader/yacreader/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248140250,"owners_count":21054268,"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":["hacktoberfest","hacktoberfest2022"],"created_at":"2024-08-01T17:00:35.448Z","updated_at":"2025-04-10T01:30:49.930Z","avatar_url":"https://github.com/YACReader.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"| Build | Master | Develop |\n|---|---|---|\n|Code Validation |[![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=master\u0026jobName=CodeFormatValidation)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=master)|[![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=develop\u0026jobName=CodeFormatValidation)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=develop)|\n|Linux | [![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=master\u0026jobName=Linux)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=master) | [![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=develop\u0026jobName=Linux)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=develop)|\n|Windows x86| [![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=master\u0026jobName=Windows_x86)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=master)|[![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=develop\u0026jobName=Windows_x86)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=develop)|\n|Windows x64| [![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=master\u0026jobName=Windows_x64)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=master)|[![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=develop\u0026jobName=Windows_x64)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=develop)|\n|MacOS | [![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=master\u0026jobName=MacOS)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=master) | [![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=develop\u0026jobName=MacOS)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=develop)|\n|Publish Build||[![Build Status](https://dev.azure.com/luisangelsm/YACReader/_apis/build/status/YACReader.yacreader?branchName=develop\u0026jobName=PublishDevBuilds)](https://dev.azure.com/luisangelsm/YACReader/_build/latest?definitionId=1\u0026branchName=develop)|\n\n# YACReader\n\n\"Yet another comic reader\"\n\n## License\nThis software has been developed by Luis Ángel San Martín Rodríguez\n(luisangelsm@gmail.com) under GPL v3 license\n(see [COPYING.txt](./COPYING.txt)).\n\n## Getting YACReader\n\n### Official releases:\n[https://github.com/YACReader/yacreader/releases](https://github.com/YACReader/yacreader/releases)\n\n[\u003cimg src=\"https://flathub.org/assets/badges/flathub-badge-en.png\" width=\"100\"/\u003e](https://flathub.org/apps/details/com.yacreader.YACReader)\n\n### As a package:\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/yacreader.svg)](https://repology.org/metapackage/yacreader)\n\n### From OBS build service:\n\n### Building from source:\n\nSee [INSTALL.md](./INSTALL.md)\n\n## Contact\n- Project home page : www.yacreader.com\n- e-mail:\n   - info@yacreader.com\n   - support@yacreader.com\n- Social:\n   - Facebook  - http://www.facebook.com/YACReader\n   - Twitter   - https://twitter.com/yacreader\n   - YouTube   - https://www.youtube.com/user/yacreader\n   - Instagram - https://www.instagram.com/yacreader/\n\nIf you need help or have any suggestion, please, send me an e-mail.\n\n## Contributing\nIf you are interested in contributing to the project the first step should be to contact me so we can plan together the best approach, you can send an e-mail or just open an issue in this repo. For small bug fixes it is usually ok to open a PR directly.\n\nContributions are not restricted to coding; you can help the project by bringing new UI/UX ideas, designing new assets, writing manuals or tutorials, translating the apps, etc. If you are interested in DevOps, YACReader uses Azure Pipelines for CI/CD, any improvements in that area are welcome. Testing pre-releases is also really appreciated.\n\n#### Dev Setup\nYACReader is developed in *c++/Qt*, so the first thing you need to do is to install a *C++* compiler or environment that supports at least *C++17* and *Qt*. In *Windows* I use *Visual Studio Community Edition 2019* as build system and in *macos* I use Xcode, but I do all the coding using *QtCreator*. The project support *Qt5* and *Qt6* at the moment so you need to make sure that everything works in both *Qt5* and *Qt6*, you only need to install one flavor of *Qt* and *CI* will check that everything builds with both, I recommend using *Qt6*.\n\nThe repo includes binaries for the dependencies needed for *Windows* (MSVC compiler) and *macos* (clang) but you need to configure *7zip* dependency manually, please take a look at *compressed_archive/README_7zip.txt*.\n\n##### Running and debugging\nYACReader needs to find its dependencies at runtime, make sure that *Qt* binaries are in your *PATH* and the third-party binaries are next to the executable. The best way to make sure you have all the third-party binaries in place is to check YACReader installation and copy the binaries in your output folder.\n\nIf you have the time and the energy, please open a PR with a script that automatizes any of these manual processes.\n\n#### Code Format\nYACReader uses `clang-format` to ensure a common style and avoid deviances from it. CI checks this and will fail if the correct format is not used. `clang-format` needs to be called recursively in all the folders because some of them have their own `.clang-format` file, mainly to exclude changing the format in third-party libraries which are included in the source code. I recommend configuring your development tools to use `clang-format`, you can try to use it manually, but please, do it always before committing changes. I recommend using QtCreator configured properly, you can find a tutorial [here]( https://www.vikingsoftware.com/using-clang-format-with-qtcreator/).\n\n#### CI/CD\nAny PR will be validated through CI, and it will not be merged if CI fails.\n\n#### Pull Requests\nThe base and target branch for any PR should always be `develop`.\n\n## Donations\nYACReader is free but it needs money to keep being alive, so please, if you like YACReader, visit the home page and make a donation.\n\n## Hacktoberfest\nIf you are interested in YACReader, please contact me so we can discuss your next steps.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FYACReader%2Fyacreader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FYACReader%2Fyacreader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FYACReader%2Fyacreader/lists"}