{"id":16703226,"url":"https://github.com/matehat/aneth","last_synced_at":"2025-10-10T18:18:53.929Z","repository":{"id":6610762,"uuid":"7854187","full_name":"matehat/aneth","owner":"matehat","description":"Quick and Dirty home cluster using Zeroconf","archived":false,"fork":false,"pushed_at":"2013-02-22T05:26:59.000Z","size":220,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-30T20:33:43.271Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://matehat.github.io/aneth/","language":"CoffeeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matehat.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-27T16:03:35.000Z","updated_at":"2019-10-10T10:48:50.000Z","dependencies_parsed_at":"2022-09-14T02:01:07.342Z","dependency_job_id":null,"html_url":"https://github.com/matehat/aneth","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matehat%2Faneth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matehat%2Faneth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matehat%2Faneth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matehat%2Faneth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matehat","download_url":"https://codeload.github.com/matehat/aneth/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248161264,"owners_count":21057554,"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-10-12T19:07:30.486Z","updated_at":"2025-10-10T18:18:48.892Z","avatar_url":"https://github.com/matehat.png","language":"CoffeeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"A quick and dirty utility that uses Zeroconf to advertize its host machine with a specified hostname\non the network. It can also listen for these advertisements and manage `/etc/hosts` accordingly,\nso that machines are automatically accessible by their provided hostname from any member running\nthat script.\n\n## What's the point?\n\nIf you're the kind of person that needs to manage multiple machines and VMs in a safe network, you might have come across \nthe annoyance of referring to them on the network (getting their IP address and so on). Wouldn't it be nice if \nthose machines just had simple names like `a.dev.local`, `b.dev.local`, `c.dev.local` and so on. Open a terminal, \ninstall **Aneth**, start it and *BOOM*, all the other machines will be able to refer to it using the name you want.\nNo playing with DHCP, UNIX hostnames, DNS or what have you. It just works.\n\n## Usage\n\n```bash\n$ aneth start \u003chostname\u003e [-s|--service \u003cserviceName\u003e] [-w|--watch] [-p|--port port] [-A|--aliases aliases]\n```\n\n* You can provide a `serviceName` parameter that will be used to listen for advertisements. \nOtherwise, `aneth-hosts` will be used.\n\n* The `--watch` options tells Aneth to watch for advertised hosts on the network and modify\n`/etc/hosts` accordingly (you'll need to execute that with `sudo` for it to work).\n\n* The `--port` options is for specifying the port number to use to advertise the current machine.\n\n* The `--aliases` options is set of local hostname aliases in the form of \n\n        --aliases from.some.domain:to.other.domain,another.one:to.another.one\n\n```bash\n$ aneth install \u003chostname\u003e [--service \u003cserviceName\u003e] [--watch]\n```\n\nThis will install Aneth so it is started on each system reboots, with the provided configurations. Currently, only Mac OS X is supported, simply using a [launchd.plist(5)][1]. I know it should work pretty easily on Linux too, but I'm no expert enough to provide a proper, portable solution. Currently, I'm simply creating a [dead-simple][3] [runit][2] setup. I'm kinda lazy, I know. You are very welcome to fork and submit a patch that would include generating and installing a generic init script (or anything really).\n\n## Installation\n\nYou will need to install globally if you want the `aneth` executable accessible anywhere.\n\n```bash\n$ npm install -g aneth\n```\n\nOn Mac, it will just work. On a linux machine, you need to install Avahi, a [Bonjour\ncompatibility library](https://github.com/agnat/node_mdns#installation).\n\nEnjoy.\n\n## License\n\nhttp://wtfpl.org\n\n[1]: http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man5/launchd.plist.5.html\n[2]: http://smarden.org/runit/\n[3]: https://gist.github.com/4652791\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatehat%2Faneth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatehat%2Faneth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatehat%2Faneth/lists"}