Confusing GetHub

By Maldalain, 9 April, 2025

Forum
macOS and Mac Apps

I am at pains to know how to download from GetHub. Specifically content here:
https://aaron-gh.github.io/Mac-Accessibility-Hub/

Options

Comments

By PaulMartz on Thursday, April 10, 2025 - 08:05

It looks to me like a list of different packages. Each package name is a heading. Navigate to the package you want, then VO+right arrow a few times to the download link.

If that's not working for you, then I need more specific info.

By Maldalain on Thursday, April 10, 2025 - 08:05

Thanks Paul for replying. When I press on the download link, I go through an ensemble of content, a link leads to another page, a button that does nothing. Why it is so confusing? I need to get some stuff from the accessibility hub, yet for the life of me I can not.

By PaulMartz on Thursday, April 10, 2025 - 08:05

I dug a little further. The download links don't download a ZIP file or anything that convenient. They just take you to the Github repository page for that project. Then you'll need to open Terminal and clone the project.

I use TDSR from Github, that's about it. It's been a while since I've pulled, but it still works. It has a dependency that I think I obtained with homebrew.

Yeah, if you're not a programmer, it's quite a mess. Okay, even if you're a programmer, it's a mess. But that's git for you.

By Levi Gobin on Thursday, April 10, 2025 - 08:05

Member of the AppleVis Editorial Team

The easiest way to clone a Github repo is to use the "git" command. You may need the xCode command line tools. You can install them with

xcode-select --install

this will bring up a GUI. Agree to the terms and conditions and install the software.

Once done, you can clone a repo like this:

git clone https://github.com/<path-to-repo>.git

Replace <path-to-repo> with the path to the repo, such as https://github.com/user/repo. Hope this helps.

By João Santos on Thursday, April 10, 2025 - 08:05

Unfortunately usability is not one of GitHub's strengths. However there's a way to make it export any commit, branch, or tag as a zip file, and I actually recommend doing that over cloning a repository, because depending on the popularity of the repository, you might end up with a huge commit history on your system (for example I avoid cloning the Linux kernel repository specifically for this reason).

The repository you linked to only contains a readme file with links to the individual project repositories. However, after clicking on the Download links, downloading the zip file is just a matter of jumping to the third heading of the entry page of the repository, which should read "Folders and Files", move the focus to the left once, and you should end up on a button named "Code". Clicking on that button will pop up a web dialog providing several download options, with the very last of them named "Download zip".

The above will provide you with the latest code snapshot of the main branch of the repository, which depending on the development policy followed by the project owners, may contain the latest bleeding edge, least tested, and potentially also unstable changes to the code, which may or may not be what you want. If it is then feel free to ignore the rest of my comment, otherwise keep reading.

Git provides a tagging feature intended to be used to mark relevant milestones, like code snapshots with some stability guarantees, and GitHub provides a per-repository page called Tags to track them, as well as a per-repository page called Releases that developers can use to publish specific tags as official versions of the project. The Tags page is only relevant in this context when the project doesn't have any releases, and both pages provide links to download zipped code snapshots. In addition to this, GitHub itself maintains a special release called latest that always points at whatever the developer considers the latest stable release of the project, so when the project has releases, it is advisable to always look for a link with the word latest in its text and then moving the VoiceOver cursor to the right until you find the link to the zip file. The tags page can be accessed through one of the links found right under the repository heading, and the Releases page is one of the last headings of a repository page after the contents of the README file.

If you have followup questions, feel free to post them here and I'll try to answer them. I use git and GitHub on a daily basis as part of my job, and have been using it for years for personal projects, so although most of my interactions with GitHub happen either through git itself or through GitHub's command-line utility, I'm quite used to the quirks of its web interface.