{"id":13467535,"url":"https://github.com/rsms/kod","last_synced_at":"2025-09-27T09:32:02.276Z","repository":{"id":1040318,"uuid":"870225","full_name":"rsms/kod","owner":"rsms","description":"Programmers' editor for OS X [DEAD PROJECT]","archived":true,"fork":false,"pushed_at":"2011-09-28T13:57:20.000Z","size":14324,"stargazers_count":2289,"open_issues_count":30,"forks_count":173,"subscribers_count":40,"default_branch":"master","last_synced_at":"2024-09-21T16:18:45.676Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://rsms.me/why-i-wrote-a-programmers-text-editor","language":"Objective-C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rsms.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}},"created_at":"2010-08-29T15:27:04.000Z","updated_at":"2024-09-18T11:12:56.000Z","dependencies_parsed_at":"2022-08-16T11:50:50.753Z","dependency_job_id":null,"html_url":"https://github.com/rsms/kod","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsms%2Fkod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsms%2Fkod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsms%2Fkod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsms%2Fkod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rsms","download_url":"https://codeload.github.com/rsms/kod/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219871971,"owners_count":16554475,"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":[],"created_at":"2024-07-31T15:00:57.609Z","updated_at":"2025-09-27T09:31:55.457Z","avatar_url":"https://github.com/rsms.png","language":"Objective-C","readme":"# Kod -- a programmers' editor for OS X\n\nA modern and open universal text editor for programmers on Mac OS X.\n\nIf you want to use Kod, simply download the latest \"stable\" version from [http://kodapp.com/download/](http://kodapp.com/download/)\n\n- General info: \u003chttp://kodapp.com/\u003e\n- Discussion forum: \u003chttp://groups.google.com/group/kod-app\u003e\n- Support (bugs): \u003chttp://kodapp.com/support/\u003e\n- Mainline source code: \u003chttps://github.com/rsms/kod\u003e\n- Twitter: [@kod_app](http://twitter.com/kod_app)\n- IRC: [irc://irc.freenode.net/#kod](irc://irc.freenode.net/#kod)\n- Developer documentation: \u003chttps://github.com/rsms/kod/wiki\u003e\n- Daily development builds: \u003chttp://kod.sivel.net/daily/\u003e\n\n## Development\n\n**Get the source (for building):**\n\n    git clone --recursive https://github.com/rsms/kod.git\n    git remote add upstream https://github.com/rsms/kod.git\n\n**Get the source (for contributing):**\n\nIf you want to contribute to the project you will have to [make a fork](http://help.github.com/forking/). Then do this:\n\n    git clone --recursive git@github.com:MyUsername/kod.git\n    git remote add upstream https://github.com/rsms/kod.git\n\n**Checkout and build libcss:**\n\nThis step isn't entirely necessary, but the first time you run this it will check out a bunch of subversion repositories which might take a few minutes.\n\n    deps/libcss/build.sh\n\n**Start hacking:**\n\n    open kod.xcodeproj\n\n\n### Refreshing your clone\n\nSince Kod is made up of a main repository as well as a few sub-repositories (git submodules) a simple `git pull` is not sufficient to update your source tree clone. Use the `update.sh` shell script for this:\n\n    ./update.sh\n\nIt will fetch updates from the upstream repository (rsms/kod). Then you should merge the branches you want to use, for example something like so:\n\n    git merge upstream/master\n\nYou can use it to update from your own repository by calling it like this:\n\n    ./update.sh origin\n\n### Contributing\n\nThe main Kod source tree is hosted on git (a popular [DVCS](http://en.wikipedia.org/wiki/Distributed_revision_control)), thus you should create a fork of the repository in which you perform development. See \u003chttp://help.github.com/forking/\u003e.\n\nWe prefer that you send a [*pull request* here on GitHub](http://help.github.com/pull-requests/) which will then be merged into the official main line repository. You need to sign the Kod CLA to be able to contribute (see below).\n\nAlso, in your first contribution, add yourself to the end of `AUTHORS.md` (which of course is optional).\n\n\n#### Creating and submitting a patch\n\nAs mentioned earlier in this article, we prefer that you send a [*pull request*](http://help.github.com/pull-requests/) on GitHub.\n\n1. Create a fork of the upstream repository by visiting \u003chttps://github.com/rsms/kod/fork\u003e. If you feel unsecure, here's a great guide: \u003chttp://help.github.com/forking/\u003e \n\n2. Clone of your repository: `git clone https://yourusername@github.com/yourusername/kod.git`\n\n3. This is important: Create a so-called *topic branch*: `git checkout -tb name-of-my-patch` where \"name-of-my-patch\" is a short but descriptive name of the patch you're about to create. Don't worry about the perfect name though -- you can change this name at any time later on.\n\n4. Hack! Make your changes, additions, etc and commit them.\n\n5. Send a pull request to the upstream repository's owner by visiting your repository's site at github (i.e. https://github.com/yourusername/kod) and press the \"Pull Request\" button. Here's a good guide on pull requests: \u003chttp://help.github.com/pull-requests/\u003e\n\n**Use one topic branch per feature** -- don't mix different kinds of patches in the same branch. Instead, merge them all together into your master branch (or develop everything in your master and then cherry-pick-and-merge into the different topic branches). Git provides for an extremely flexible workflow, which in many ways causes more confusion than it helps you when new to collaborative software development. The guides provided by GitHub at \u003chttp://help.github.com/\u003e are a really good starting point and reference.\nIf you are fixing a ticket, a convenient way to name the branch is to use the URL slug from the bug tracker, like this: `git checkout -tb 53-feature-manually-select-language`.\n\n\n#### Contributor License Agreement\n\nBefore we can accept any contributions to Kod, you need to sign this [CLA](http://en.wikipedia.org/wiki/Contributor_License_Agreement):\n\n[http://kodapp.com/cla.html](http://kodapp.com/cla.html)\n\n\u003e The purpose of this agreement is to clearly define the terms under which intellectual property has been contributed to Kod and thereby allow us to defend the project should there be a legal dispute regarding the software at some future time.\n\nFor a list of contributors, please see [AUTHORS](https://github.com/rsms/kod/blob/master/AUTHORS.md) and \u003chttps://github.com/rsms/kod/contributors\u003e\n\n\n## License\n\nSee the file `LICENSE`\n","funding_links":[],"categories":["Objective-C","etc"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsms%2Fkod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frsms%2Fkod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsms%2Fkod/lists"}