{"id":13588292,"url":"https://github.com/technusm1/kiwings","last_synced_at":"2025-04-08T03:33:29.889Z","repository":{"id":51537953,"uuid":"378472217","full_name":"technusm1/kiwings","owner":"technusm1","description":"A better alternative to Kiwix for macOS","archived":false,"fork":false,"pushed_at":"2022-11-30T12:22:59.000Z","size":10162,"stargazers_count":15,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-06T07:40:35.167Z","etag":null,"topics":["kiwix","kiwix-server","macos","swift","swiftui"],"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/technusm1.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":"2021-06-19T17:46:57.000Z","updated_at":"2024-08-07T17:25:06.000Z","dependencies_parsed_at":"2022-08-21T16:00:27.367Z","dependency_job_id":null,"html_url":"https://github.com/technusm1/kiwings","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technusm1%2Fkiwings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technusm1%2Fkiwings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technusm1%2Fkiwings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technusm1%2Fkiwings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/technusm1","download_url":"https://codeload.github.com/technusm1/kiwings/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247772697,"owners_count":20993625,"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":["kiwix","kiwix-server","macos","swift","swiftui"],"created_at":"2024-08-01T15:06:37.278Z","updated_at":"2025-04-08T03:33:28.245Z","avatar_url":"https://github.com/technusm1.png","language":"Swift","funding_links":[],"categories":["Swift"],"sub_categories":[],"readme":"#  KiWings\n\n| Field                                                                  | Info                                   |\n|------------------------------------------------------------------------|----------------------------------------|\n| Project Homepage | [github.com/technusm1/kiwings](https://github.com/technusm1/kiwings) |\n| Description | Lightweight Kiwix alternative for macOS |\n| Build status | ![Build status](https://github.com/mkathuri/kiwings/actions/workflows/main.yml/badge.svg) |\n| Download latest version | [1.0-beta4](https://github.com/technusm1/kiwings/releases/download/1.0-beta4/Kiwings.1.0-beta4.dmg) |\n\n\n## Introduction\nKiWings is a lightweight Kiwix alternative for macOS. Kiwix is an open-source tool that allows you to read offline copies of fantastic content like Wikipedia (its a 80GB download), TED Talks etc. Originally, I started working on this tool to learn UI development on macOS, an endeavor that continues to this day. But this tool has now become a full-fledged project itself.\n\nUnder the hood, this tool is a front-end for `kiwix-serve` designed for macOS 11.3 and later. `kiwix-serve` is a tool designed by Kiwix team, which can work as a standalone content server, but as of writing this, is not directly released as macOS binary, though compilation is supported.\n\n**🔥WARNING: Bugs and shortcomings are unfortunately commonplace in software. On my part, I'm releasing the tool as a sandboxed app (meaning macOS will restrict its capabilities to do any damage), but this tool is RELEASED AS IS, WITH NO WARRANTY - IMPLIED OR OTHERWISE.**\n\n## Features\n- Sandboxed. Less chances of damaging your computer. More peace of mind.\n- Menu bar app that's available when you need it.\n- Automatically detects different installed browsers on your machine, and allows you to conveniently access your content library from any of them (see screenshots).\n- Open-source\n\n## Screenshots\n\n| Stopped                                                                  | Running                                   |\n|---------------------------------------------------------------------------------|-----------------------------------------------|\n| ![KiWings Stopped](https://github.com/technusm1/kiwings/raw/main/screenshots/Screenshot-Stopped.png) | ![KiWings Running](https://github.com/technusm1/kiwings/raw/main/screenshots/Screenshot-Running.png) |\n\n## Installation \u0026 Requirements\n- Please make sure you have macOS 11.3 or later installed on your machine.\n- Download the latest release from [here](https://github.com/technusm1/kiwings/releases/download/1.0-beta4/Kiwings.1.0-beta4.dmg) (currently in beta, but should be usable).\n- Open the DMG file in Finder.\n- Drag and Drop the KiWings app into your Applications folder.\n\n## Build Instructions\nThere are 3 simple steps:\n- Checkout the project via git or download the source archive.\n- Open the project in Xcode (tested on 12 and 13).\n- Build it. It needs internet to fetch the underlying dependencies, so make sure you are connected to the internet.\n\nEasy, right?\n\n## Giving feedback\nBefore you raise an issue, please make sure to search the **Issues** section properly to see if there isn't any issue already filed for the problem you're facing. Being a bit busy these days, it may not be possible for me to attend to your concerns in a timely manner. That said, your feedback is extremely valuable and appreciated. I may not be able to reply, but I do read in a timely manner.\n\n## Credits\n- Kiwix team's `kiwix-tools`. Source code is available here: https://github.com/kiwix/kiwix-tools\n- Sindre Sorhus's `LaunchAtLogin` package: https://github.com/sindresorhus/LaunchAtLogin\n- CheckboxHeaderCell gist here: https://gist.github.com/Lessica/176c2314336fc861398de1e1045aa368\n- Detecting button press in SwiftUI: https://stackoverflow.com/a/70191752/4385319\n- Enumerating installed browsers on OSX: https://stackoverflow.com/a/931277/4385319\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnusm1%2Fkiwings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechnusm1%2Fkiwings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnusm1%2Fkiwings/lists"}