{"id":16975117,"url":"https://github.com/foso/folders2kt","last_synced_at":"2025-07-15T14:18:31.635Z","repository":{"id":94180710,"uuid":"437616631","full_name":"Foso/Folders2kt","owner":"Foso","description":"An interpreter/transpiler, written in Kotlin, for the esoteric programming language Folders, a language with no code and just folders","archived":false,"fork":false,"pushed_at":"2025-02-26T07:25:00.000Z","size":1526,"stargazers_count":33,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-26T08:29:20.174Z","etag":null,"topics":["esolang","folders","interpreter","transpiler"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Foso.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-12T17:52:29.000Z","updated_at":"2025-02-26T07:25:03.000Z","dependencies_parsed_at":"2025-02-26T08:23:44.111Z","dependency_job_id":"e1700c8c-0e4c-4973-bef4-a6d99a7f55e3","html_url":"https://github.com/Foso/Folders2kt","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/Foso%2FFolders2kt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foso%2FFolders2kt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foso%2FFolders2kt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foso%2FFolders2kt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Foso","download_url":"https://codeload.github.com/Foso/Folders2kt/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243853617,"owners_count":20358451,"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":["esolang","folders","interpreter","transpiler"],"created_at":"2024-10-14T01:09:18.187Z","updated_at":"2025-03-17T08:38:05.087Z","avatar_url":"https://github.com/Foso.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eFolders2kt 📁\u003c/h1\u003e\nAn Interpreter/Transpiler of the Folders esoteric programming language, a language with no code and just folders, written in Kotlin\n\n\n[![justforfunnoreally.dev badge](https://img.shields.io/badge/justforfunnoreally-dev-9ff)](https://justforfunnoreally.dev)\n[![jCenter](https://img.shields.io/badge/Apache-2.0-green.svg\n)](https://github.com/Foso/Folders2kt/blob/master/LICENSE)\n  \u003ca href=\"https://twitter.com/intent/tweet?text=Hey, check out Folders2kt https://github.com/Foso/Folders2kt via @jklingenberg_ \n\"\u003e\u003cimg src=\"https://img.shields.io/twitter/url/https/github.com/angular-medellin/meetup.svg?style=social\" alt=\"Tweet\"\u003e\u003c/a\u003e\n\n### Show some :heart: and star the repo to support the project\n\n[![GitHub stars](https://img.shields.io/github/stars/Foso/Folders2kt.svg?style=social\u0026label=Star)](https://github.com/Foso/Folders2kt) [![GitHub forks](https://img.shields.io/github/forks/Foso/Folders2kt.svg?style=social\u0026label=Fork)](https://github.com/Foso/Folders2kt/fork) [![GitHub watchers](https://img.shields.io/github/watchers/Foso/Folders2kt.svg?style=social\u0026label=Watch)](https://github.com/Foso/Folders2kt) [![Twitter Follow](https://img.shields.io/twitter/follow/jklingenberg_.svg?style=social)](https://twitter.com/jklingenberg_)\n\n## Introduction\n\n\n\"Folders is a language where the program is encoded into a directory structure. All files within are ignored, as are the names of the folders. Commands and expressions are encoded by the pattern of folders within folders. \"\nFolders was created by Daniel Temkin https://danieltemkin.com/Esolangs/Folders/. If you want to learn more about the language, check https://www.youtube.com/watch?v=Igh-vBI2LXc\n\nThis is what a \"Hello World\"-program looks like:\n\u003cp align=\"center\"\u003e\n  \u003cimg src =\"https://raw.githubusercontent.com/Foso/Folders2kt/master/docs/helloworld.png\" height=500 /\u003e\n\u003c/p\u003e\n\nFolders2kt can execute this programs on the JVM or print you Kotlin source code for it. \n\n### Run it\nTo execute a Folders program you need to add the directory path of the program with the \"-d\" parameter\n\n\u003ckbd\u003e java -jar Folders2kt-1.0-SNAPSHOT-all.jar -d /Users/jklingenberg/Code/2021/Folders2kt/sample_programs/99Bottles \u003c/kbd\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src =\"https://raw.githubusercontent.com/Foso/Folders2kt/master/docs/execute.png\" height=50 /\u003e\n\u003c/p\u003e\n\n### Print Source\nTo execute a Folders program you need the directory path of the program with the \"-d\" parameter and the \"-source\" parameter\n\n\u003ckbd\u003e java -jar Folders2kt-1.0-SNAPSHOT-all.jar -d /Users/jklingenberg/Code/2021/Folders2kt/sample_programs/99Bottles -source \u003c/kbd\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src =\"https://raw.githubusercontent.com/Foso/Folders2kt/master/docs/source.png\" height=200 /\u003e\n\u003c/p\u003e\n\n# 🏠 Architecture\n\n## 🛠️ Built With\n### Kotlin\n[![jCenter](https://img.shields.io/badge/Kotlin-2.0.0-green.svg\n)]()\n\n\n\n### Project Structure\n* \u003ckbd\u003esrc/main\u003c/kbd\u003e - Source code of the interpreter\n* \u003ckbd\u003esample_programs\u003c/kbd\u003e - Example programs I got from https://github.com/SinaKhalili/Folders.py\nYou need to extract the zips before you can run them.\n\n## ✍️ Feedback\n\nFeel free to send feedback on [Twitter](https://twitter.com/jklingenberg_) or [file an issue](https://github.com/foso/Folders2kt/issues/new). Feature requests are always welcome. \n\n\n## 📜 License\n\nThis project is licensed under the Apache License, Version 2.0 - see the [LICENSE.md](https://github.com/Foso/Folders2kt/blob/master/LICENSE) file for details\n\n### Find this project useful ? :heart:\n* Support it by clicking the :star: button on the upper right of this page. :v:\n\nLicense\n-------\n\n    Copyright 2021 Jens Klingenberg\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoso%2Ffolders2kt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoso%2Ffolders2kt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoso%2Ffolders2kt/lists"}