{"id":13846147,"url":"https://github.com/goranmoomin/HackerNews","last_synced_at":"2025-07-12T04:31:20.353Z","repository":{"id":41373797,"uuid":"232215392","full_name":"goranmoomin/HackerNews","owner":"goranmoomin","description":"macOS HackerNews client that aims to be a Mac-assed Mac app. Written in Swift + AppKit.","archived":false,"fork":false,"pushed_at":"2023-08-14T16:08:21.000Z","size":3011,"stargazers_count":428,"open_issues_count":6,"forks_count":12,"subscribers_count":11,"default_branch":"main","last_synced_at":"2024-08-05T17:45:47.022Z","etag":null,"topics":["appkit","hackernews","macos","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/goranmoomin.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}},"created_at":"2020-01-07T01:13:19.000Z","updated_at":"2024-07-27T21:32:17.000Z","dependencies_parsed_at":"2024-02-21T10:58:41.189Z","dependency_job_id":null,"html_url":"https://github.com/goranmoomin/HackerNews","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goranmoomin%2FHackerNews","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goranmoomin%2FHackerNews/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goranmoomin%2FHackerNews/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goranmoomin%2FHackerNews/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/goranmoomin","download_url":"https://codeload.github.com/goranmoomin/HackerNews/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225791566,"owners_count":17524808,"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":["appkit","hackernews","macos","swift"],"created_at":"2024-08-04T17:04:30.512Z","updated_at":"2024-11-21T19:31:15.460Z","avatar_url":"https://github.com/goranmoomin.png","language":"Swift","readme":"#  HackerNews.app\n\n![Screenshot of main window](https://user-images.githubusercontent.com/37990858/110665546-d2ee0f00-820b-11eb-86f2-290395bcd2ba.png)\n\n---\n\nI couldn't find a HackerNews client that runs on macOS, built with native technologies (AppKit), and has all of the\nfeatures I was interested in: up/downvote features, commenting, hiding/favoriting, etc...\n\nSo I'm building on my own. \n\n## ⚠️ Warning\n\nThis app is still highly WIP, and it's not the best code in the world.\nIf you have any ideas to make the code cleaner, Swiftier, or really have any idea, PRs are welcomed!\n\nAlso welcomed is trivial bug reports, I would like to fix bugs that are lying on the ground but\nas I use the app daily, it's hard for me to find out very obvious bugs because I'm so used to it.\nEvery bug report helps, including very trivial ones. Thanks in advance.\n\n### Pre release\n\nI did a pre release, you might want to try it out by downloading it from the\n[releases tab](https://github.com/goranmoomin/HackerNews/releases).\n\nIf you're getting a warning that says the application is damaged, the temporary solution is to clear the quarantine flag\nby running `xattr -c ~/Downloads/HackerNews.app` in the Terminal. Sorry for the inconvenience, will fix this soon.\n\n## Development\n\nI wrote the [HNAPI](https://github.com/goranmoomin/HNAPI) package for interfacing with HN. It handles\ncommunicating with both the [HN official API](https://github.com/HackerNews/API), the\n[Algolia HN API](https://hn.algolia.com/api), and the [HackerNews site](https://news.ycombinator.com).\n\nIf you're writing a new HN client (for any platform), you might want to gleam the code, I've put in a lot of thoughts in\nthe design. There's probably a bit more design aspects that I have to think about, but it's pretty much the fastest and \nthe most robust approach to interfacing HN that I could think.\n\n## Features\n\n### Voting stories and comments\n\nA surprising amount of HackerNews clients don't have any functionality related to accounts.\nThat's mostly because the [official API](https://github.com/HackerNews/API) only provides methods to view items.\nIn contrast, HackerNews.app loads the HN site, parses it and allows users to vote, favorite, or hide items.\n\n### [Mac-assed Mac app](https://inessential.com/2020/03/19/proxyman)\n\nThis app tries to be a [Mac-assed Mac app](https://inessential.com/2020/03/19/proxyman).\nIt is developed using the AppKit APIs, and doesn't use webviews or Catalyst.\n\n## Thanks to...\n\n[Collin Donnell](https://keyandnib.com) ([@collindonnell](https://twitter.com/collindonnell) on Twitter),\nwho has generously provided code review and design advice on this project.\n","funding_links":[],"categories":["Swift"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoranmoomin%2FHackerNews","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoranmoomin%2FHackerNews","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoranmoomin%2FHackerNews/lists"}