{"id":26889769,"url":"https://github.com/ardatetikbey/standalone-ruby","last_synced_at":"2025-05-12T00:34:46.327Z","repository":{"id":284743405,"uuid":"955847991","full_name":"ardatetikbey/Standalone-Ruby","owner":"ardatetikbey","description":"A project that allows you to convert your Ruby projects to exe files and make them independent of Ruby installations.","archived":false,"fork":false,"pushed_at":"2025-04-11T15:38:26.000Z","size":41372,"stargazers_count":30,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T16:27:34.634Z","etag":null,"topics":["batch","ruby","ruby-exe","rubylang","standalone-ruby","vbscript"],"latest_commit_sha":null,"homepage":"https://rubygems.org/gems/standalone-ruby","language":"Ruby","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/ardatetikbey.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2025-03-27T09:44:29.000Z","updated_at":"2025-04-11T15:38:29.000Z","dependencies_parsed_at":"2025-04-11T16:37:16.115Z","dependency_job_id":null,"html_url":"https://github.com/ardatetikbey/Standalone-Ruby","commit_stats":null,"previous_names":["ardatetikbey/standalone-ruby"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ardatetikbey%2FStandalone-Ruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ardatetikbey%2FStandalone-Ruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ardatetikbey%2FStandalone-Ruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ardatetikbey%2FStandalone-Ruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ardatetikbey","download_url":"https://codeload.github.com/ardatetikbey/Standalone-Ruby/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253655899,"owners_count":21943069,"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":["batch","ruby","ruby-exe","rubylang","standalone-ruby","vbscript"],"created_at":"2025-03-31T21:56:27.058Z","updated_at":"2025-05-12T00:34:46.315Z","avatar_url":"https://github.com/ardatetikbey.png","language":"Ruby","readme":"# Project: Standalone Ruby\n\n---\n\n## Overview\n\n- Convert your Ruby projects to exe files!\n- For a program output example you can take a look at in the [example](https://github.com/ardatetikbey/Standalone-Ruby/tree/main/example) folder.\n\n---\n\n## Installation\n\n```bash\ngem install standalone-ruby\n```\n\n---\n\n## Parameters\n\n```\nC:\\Users\\ardat\u003estandalone-ruby -h\nStandalone-Ruby - Convert your Ruby projects to exe files!\n\nUsage: standalone-ruby [--help] [--project-path PROJECT_PATH] [--ruby-path RUBY_PATH] [--main-file MAIN_FILE] [--launcher LAUNCHER] [--gui]\n                       [--template TEMPLATE] [--exe-file EXE_FILE] [--threads THREADS] [--resource-file resource_file] [--gcc] [--version]\n\nRequired Options:\n  --project-path PROJECT_PATH\n      Target Ruby project path.\n\n  --ruby RUBY_PATH\n      Path to the Ruby interpreter.\n\n  --main-file MAIN_FILE\n      Path to the main Ruby file of the project.\n\nExtra Options:\n  --exe-file EXE_FILE\n      Name of the exe file to be used for output (default is program.exe).\n\n  --threads THREADS\n      Number of threads to use (default is 5). Determines the number of threads used during the Ruby interpreter\n      copy process and for Robocopy operations. A higher number of threads can speed up the process, but requires more system resources.\n\n  --resource-file RESOURCE_FILE\n      Resource file (.rc) for the exe file to be created. Only possible with MinGW.\n\n  --help\n      Show this help message and exit.\n\n  --version\n      Show program version and exit.\n\n  --gcc\n      Use GCC compiler for exe file.\n      \n  --gui\n      This option allows the rubyw.exe file in the bin folder to be used.\n      You can choose it for projects that include GUI.\n```\n\n---\n\n## Usage\n\n### Basic Usage\nYou can obtain an .exe file with the following command:\n\n```bash\nstandalone-ruby --ruby-path C:\\Ruby34-x64 --main-file C:\\Users\\ardat\\Desktop\\example\\main.rb --project-path C:\\Users\\ardat\\Desktop\\example\n```\n\n### Detailed Usage\nWe will use the GCC compiler in detailed usage. Please make sure that MinGW is installed on your computer.\n\n```bash\nstandalone-ruby --ruby-path C:\\Ruby34-x64 --main-file C:\\Users\\ardat\\Desktop\\example\\main.rb --project-path C:\\Users\\ardat\\Desktop\\example --exe-file program.exe --gcc --resource-file C:\\Users\\ardat\\Desktop\\C\\program.rc\n```\n\nTo create a .exe file with a custom icon, you need to use GCC.\n\nAdd the value defined by the --resource-file parameter to the top of the .rc file, as in the example:\n\nExample:\n\n```\n#include \u003cwindows.h\u003e\n\n1 ICON \"C:\\\\Users\\\\arda\\\\Desktop\\\\test.ico\"  // Your ICON path\n\n1 VERSIONINFO\n FILEVERSION 1,0,0,0\n PRODUCTVERSION 1,0,0,0\n BEGIN\n   BLOCK \"StringFileInfo\"\n   BEGIN\n     BLOCK \"040904B0\"\n     BEGIN\n       VALUE \"CompanyName\", \"ArdaTetik\\0\"\n       VALUE \"FileDescription\", \"MyProgram\\0\"\n       VALUE \"FileVersion\", \"1.0.0.0\\0\"\n       VALUE \"ProductName\", \"MyProgram\\0\"\n     END\n   END\n END\n\n```\n\n---\n\n## Notes\n\n- Make sure that the Ruby interpreter you are using includes all the gem files for the project you will be running.\n- Make sure that the provided paths are valid and accessible from your system.\n- The `threads` option can significantly impact performance during the copying process, so use it wisely based on your system’s capabilities.\n- The location changes of the project directories might prevent the program from working.\n- Although it is very rare, some antiviruses can detect the exe files as viruses. This is not my fault,\n  you may encounter such results when converting dynamic languages ​​to exe. I have solved most of this problem.\n\n---\n\n## To Do List\n\n- Packaged One-File Exe Support - The output of the exe file will be able to used as a single file.\n- CLI Support - Support will be added for the programs that take parametres from the command line.\n- Zip Packaging - Zip packaging support will be added to decrease the size of the output.\n- Encrypted Ruby Execution - Ruby scripts will be encrypted for protection and will have an option to be decrypted and executed.\n\n---\n\n## License\n\n- This project is licensed under the MIT License.\n\n---\n\n## Thanks!\n- https://github.com/TrueHalo - I would like to thank Ahmet Bahadır Bakır for his help in translating the documents.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fardatetikbey%2Fstandalone-ruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fardatetikbey%2Fstandalone-ruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fardatetikbey%2Fstandalone-ruby/lists"}