{"id":15720800,"url":"https://github.com/dom96/aporia","last_synced_at":"2026-04-01T17:21:53.932Z","repository":{"id":63553604,"uuid":"621775","full_name":"dom96/Aporia","owner":"dom96","description":"IDE/Advanced text editor mainly focusing on support for the Nim programming language.","archived":false,"fork":false,"pushed_at":"2018-03-19T20:31:50.000Z","size":21989,"stargazers_count":381,"open_issues_count":25,"forks_count":35,"subscribers_count":31,"default_branch":"master","last_synced_at":"2025-04-06T12:08:38.677Z","etag":null,"topics":["gtk2","ide","nim"],"latest_commit_sha":null,"homepage":"","language":"Nim","has_issues":true,"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/dom96.png","metadata":{"files":{"readme":"readme.markdown","changelog":"changelog.markdown","contributing":null,"funding":null,"license":"copying.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-04-21T15:28:59.000Z","updated_at":"2025-03-26T21:43:27.000Z","dependencies_parsed_at":"2022-11-21T06:45:24.007Z","dependency_job_id":null,"html_url":"https://github.com/dom96/Aporia","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dom96%2FAporia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dom96%2FAporia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dom96%2FAporia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dom96%2FAporia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dom96","download_url":"https://codeload.github.com/dom96/Aporia/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247478323,"owners_count":20945266,"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":["gtk2","ide","nim"],"created_at":"2024-10-03T22:00:15.852Z","updated_at":"2026-03-27T04:11:05.392Z","avatar_url":"https://github.com/dom96.png","language":"Nim","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aporia\n\n**Note:** As of 2018 Aporia is considered obsolete. Most of the Nim community\nhas switched to VS Code instead. Feel free to use Aporia, but know that it\nmay not be maintained anymore.\n\nAporia is an IDE for the Nim programming language. Aporia uses GTK as the\ndefault toolkit, and the gtksourceview for the text editor component.\n\n![Aporia on Windows 7](https://github.com/nim-lang/Aporia/raw/master/screenshots/windows.png \"Aporia on Windows 7\")\n\n![Aporia on Mac OS X](https://github.com/nim-lang/Aporia/raw/master/screenshots/osx.png \"Aporia on Mac OS X\")\n\n## Installing\n\nThe method by which Aporia can be installed depends on your platform. The\nfollowing installation instructions are valid as of version 0.4.1 of Aporia.\n\n### Windows\n\nNo windows binaries available right now I'm afraid. Sorry!\n\nYou can install Aporia via the Nimble package manager, take a look at\nthe Linux/BSD installation instructions to see how this can be done.\nKeep in mind that you will\nneed to also install Aporia's dependencies manually if you install Aporia\nthis way. The dependencies are listed below under the\n[#dependencies](#dependencies) section.\n\n### Mac OS X\n\nAs of version 0.4.0 Aporia now offers very good Mac OS X support. The\n[releases](https://github.com/nim-lang/Aporia/releases) page contains a\nzipped archive to an Aporia app bundle, which you can download and begin\nusing immediately!\n\nFor your convenience, here is the app bundle for Aporia v0.4.0:\nhttps://github.com/nim-lang/Aporia/releases/download/v0.4.0/Aporia_0.4.0_MacOSX.zip\n\n### Linux/BSD\n\nSome Linux/BSD distributions may package Aporia so make sure to search for it\nusing your favourite package manager. For example, AUR offers an\n[``aporia-git``](https://aur.archlinux.org/packages/aporia-git/) package.\n\nIn most cases, you will need to compile and install Aporia manually. The\neasiest way to do so is using [Nimble](http://github.com/nim-lang/nimble).\nFirst, if you haven't already done so, install Nimble. The instructions for\ndoing so can be found [here](https://github.com/nim-lang/nimble#installation).\n\nOnce Nimble is installed, you can install Aporia by executing the following\nin a terminal:\n\n```bash\nnimble install aporia\n```\n\nThis will download the latest Aporia release, compile it and install it to\n``~/.nimble/pkgs/`` and ``~/.nimble/bin/aporia``. You can then execute Aporia\nby executing ``~/.nimble/bin/aporia`` from your terminal. You can add\n``~/.nimble/bin`` to your ``$PATH`` to make the execution easier.\n\nIf Aporia fails to start with an error similar to the following:\n\n```\ncould not load: libgtk2.so\n```\n\nThen you will need to use your Linux/BSD distribution's package manager to\ninstall Aporia's dependencies. These include ``gtk2``, ``gtksourceview``\n(version 2, not 3), and ``pcre``. More information about these can be found\nin the [#dependencies](#dependencies) section.\n\n## Compiling\n\nTo compile Aporia you need the latest version of the nim compiler, preferably\nthe unstable release from github. Aporia sometimes relies on bug fixes\nwhich have not yet made it to a stable release.\n\nTo build Aporia execute ``nimble build`` in its directory. To build and install\nAporia execute ``nimble install`` in its directory.\n\nYou can also quickly install it using nimble without the need to clone this repo\nyourself, just execute ``nimble install aporia@#head``.\n\n**Note:** You also need to install some dependencies for Aporia to run. The\nsection below explains this in more detail.\n\nAssuming that all dependencies are installed and you installed Nimble properly,\nyou will be able to launch Aporia by executing ``aporia`` in the terminal.\n\n### Compiling from C sources\n\nIf you do not want to get the nim compiler you can still compile Aporia from\nthe generated C sources, it's as simple as executing the ``build.sh`` script\n(or ``build.bat`` on Windows). You can then also use ``install.sh`` to install\nAporia.\n\n## Dependencies\n\nAporia depends on the following libraries. You may already have those installed\nespecially if you are on Linux.\n\n* GTK (version 2!)\n* GtkSourceView (any version compatible with GTK2)\n* PCRE\n\n### Windows\n\n**Warning:** If you are on a 64bit version of Windows you must not compile Aporia using a 64 bit version of Nim.\nThis is because there are no 64 bit GTK+ binaries available, see discussion [here](https://github.com/nim-lang/Aporia/issues/51).\n\n#### GTK+\n\nIf you already have GTK+ on your system, you don't need to do anything. Just\nmake sure GTK+ is in your PATH.\n\nIf you don't have GTK+ installed then you need to install it. You can get the\nlatest version from [here](http://sourceforge.net/projects/gtk-win/ \"GTK+ Runtime\").\nMake sure that the installer adds GTK+ to the PATH.\n#### GtkSourceView\nThe GtkSourceView doesn't have an installer, however binaries are available\nfrom [here](http://ftp.acc.umu.se/pub/gnome/binaries/win32/gtksourceview/ \"GtkSourceView\")\n (these are 32 bit only!). Just pick\nthe latest version and download the archive then copy the files/folders\nin the archive into the 'bin' directory in gtk's directory\n(Most likely: ``C:\\Program Files\\GTK2-Runtime\\bin``).\n#### libxml2-2\nGtkSourceView depends on libxml2-2. This should be downloaded from\n[here](http://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ \"dependencies\")\n (these are 32 bit only!).\nAnd the contents of it should be copied the same 'bin' directory as GtkSourceView above.\nThe zip you are looking for is usually called ``libxml2_2.X.X-1_win32.zip``\n#### pcre\nThe dll for this can be found in nim's repo, in the ``\"dist\"`` directory. Just\ncopy it into aporia's directory or somewhere into your PATH.\n#### Microsoft Visual C++ 2010 Redistributable Package (*optional*)\nIf you are experiencing a ``MSVC100.dll cannot be found`` then you may need to install\nthe Microsoft Visual C++ 2010 Redistributable Package, this can be downloaded from [here](http://www.microsoft.com/download/en/details.aspx?id=5555)\n ([win64](http://www.microsoft.com/download/en/details.aspx?id=14632))\n\n### Linux\n\nUse your package manager to install the dependencies\n(gtk2, gtksourceview and PCRE).\n\n### Mac OS X\n\nThe easiest way to get Aporia running on Mac OS X is by installing its\ndependencies using Homebrew.\n\n```bash\n$ brew install gtk gtksourceview\n```\n\nTo get a nice OS X theme you will also need the GTK Quartz engine. The best\none to get is from [TingPing/homebrew-gnome](https://github.com/TingPing/homebrew-gnome).\n\n```bash\n$ brew tap TingPing/gnome\n$ brew install --HEAD gtk-quartz-engine\n```\n\nTo use the Quartz engine you must also define the following environment\nvariables.\n\n```bash\nexport GTK_DATA_PREFIX=/usr/local\nexport GTK_EXE_PREFIX=/usr/local\nexport GTK2_RC_FILES=$(nimble path aporia | tail -n 1)/share/themes/Quartz/gtk-2.0/gtkrc\n```\n\nYou can put those in your ``.bash_rc`` file or similar to make it system-wide.\n\nFor El Capitan Mac OSX\n\n```bash\nbrew tap homebrew/dupes\nbrew install libiconv\ncd /usr/local/lib/\nsudo ln -s libgdk-quartz-2.0.dylib libgdk-x11-2.0.dylib\nsudo ln -s libgtk-quartz-2.0.dylib libgtk-x11-2.0.dylib\n```\n\n**Note:** For this to work you must have Aporia installed via Nimble.\n\nIf running ``aporia`` now tells you about a missing dynamic library,\ndependencies might have changed and you could need to ``brew install`` another\npackage (tell us this is broken by [creating an\nissue](https://github.com/nim-lang/Aporia/issues) and we will update the\ndocumentation).\n\nAssuming that you have set everything up correctly, you should see an Aporia\nwindow that looks like this:\n\n![Aporia on Mac OS X](https://github.com/nim-lang/Aporia/raw/master/screenshots/osx.png \"Aporia on Mac OS X\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdom96%2Faporia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdom96%2Faporia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdom96%2Faporia/lists"}