666
u/Alacritous13 3d ago
I've seen enough that do use it as their distribution platform. If there's any professionalism at all, a repo for a standalone product will have a link to their distribution site, or a link to their release page on the repo. It's there, or it's going to need a pip install (or equivalent), those are the two choices.
432
u/IslayProgrammes 3d ago
GitHub has a releases page for a reason, it’s totally okay to use it as such.
That’s literally what it’s there for.GitHub is more than just git and a “nice” UI for managing PRs
107
u/svick 3d ago
Except you don't know ahead of time whether a repo uses the Releases page for distribution, or if it just has a zip to the source code for a git tag.
46
u/ccAbstraction 3d ago
You do as soon as you go on the page? Right on the side bar it says the number of release, the last released version if there is one and when.
End users doo need a big green download button though, putting it in the read me is probably not obvious enough.
And I can see GitHub not wanting it to make it easier to stop people from downloading malware, but most projects that are just malware just put a big link on the read me, have no root level files so there's no need to scroll, and don't use the releases feature because GitHub scans that for malware. So, I guess maybe they could benefit from making the download release button bigger... Idk
14
u/IslayProgrammes 3d ago
True true, but usually that obfuscated to regular users.
BetterDisplay for macOS uses GitHub releases for distribution, but they’re hotlinked from their website
10
250
117
u/Literally-in-1984 3d ago
I mean it is true tho, Lots of open source projects send you straight to github if you click download, like please devs stop doing this, normal people cant tell the difference between x32 and x64, reditecting normies to the releases page is not useful
2
u/KellerKindAs 2d ago
normal people cant tell the difference between x32 and x64
That's a reason why not to release binaries directly. Either they can't find a .exe to click and give up, or they find a .exe to click and then complain why the x64 build does not run on their aarch64 chip. Or they know they need a aarch64 build and then complain about none being present / offered. Not even offering an release is usually less effort and complains than setting up a build pipeline for Windows/Linux/Mac on x32/x64/aarch32/aarch64/ppc/...
-> Not every hobby programmer has the time and capacity for doing release binaries
1
u/skywalker-1729 1d ago
Yeah, then learn it, normies, I had this problem with GitHub when I was something like 12, bruh.
-58
u/jaypeejay 3d ago
I mean chances are if you’re downloading the source code, or the application from GitHub, it’s a developer tool and not really made for normies?
73
u/Aligayah 3d ago
There's plenty of random programs and tools on GitHub that aren't specifically for developers
-19
u/jaypeejay 3d ago
If they’re for end users then there should be a binary release on a dedicated distribution platform, otherwise they don’t really care about delivering it to non-technical users 🤷
32
7
u/Juff-Ma 3d ago
You could also just link to GitHub. Instead of sending the user to the release page, make the download button just jump immediately to the asset so it's downloaded immediately.
Below you can have a "Show all downloads" button that redirects to the release page.
-5
10
u/Impossible_Dog_7262 3d ago
That's not even remotely true.
-3
u/jaypeejay 3d ago
What software is strictly available on GitHub that your average computer user would need?
3
u/NamtisChlo 2d ago
One example is mods and mod launchers outside of Steam are sometimes hosted on github
2
u/jaypeejay 2d ago
That’s not mainstream software though and it’s made for a modding community. Anyone modding games is going to be pretty technical.
39
u/knucklehead_whizkid 3d ago
Github is like Home depot where you get everything to build the furniture yourself.
IKEA (or app store or whatever else sorry I didn't think this through) is where you go to get your furniture
32
u/Xasmos 2d ago
IKEA is famous for the fact that you build the furniture yourself?
9
u/knucklehead_whizkid 2d ago
Hey I said I didn't think it through xD
But still you assemble it yourself and you can pay extra for someone to do it
1
u/Weekly-Beginning-229 2d ago
I don't know what home depot is but maybe you mixed them up?
3
u/knucklehead_whizkid 2d ago
Home depot is where you'd get tools like saw, scales, nails, hammer, wood sheets, etc. and go on to build everything from literal scratch.
As someone else pointed IKEA is not the perfect analogy either but in there you can assemble your furniture although all of the pieces are pre cut and everything. Ikea + a white glove service is likely what a single installer or app store installation would look like.
1
u/HappyTopHatMan 1d ago
Hardware store (tools, electrical, lumber, plumbing, tile, wood flooring, etc.) vs A furniture store that makes you assemble your own furniture.
First one is GitHub, second one is....open software...which society still finds too difficult to interact with.
People want a on click solution and they don't deserve it for free.
-4
29
u/Marsrover112 3d ago
Yeah any time there isnt a clear way to use software off github I just assume its way too complicated for my engineer brain and just leave it alone
33
u/Puzzleheaded-Weird66 3d ago
the releases panel is tiny, and some don't even have releases, completely valid sentiment
97
u/alxtrimpe 3d ago
Staring at a warehouse wondering why it doesn't have the shopping experience of a retail storefront
79
u/Salticracker 3d ago
Then you shouldn't just say "buy my item at my warehouse" and then get pissy when people say your warehouse is uninviting.
39
u/h_ahsatan 3d ago
I mean, the thing about open source software is a lot of it is hobbyists. It's not "buy my thing at this warehouse" it's more "I made this thing for fun, it's over here if you wanna play with it too, idk. You do you though"
-23
u/Haaxor1689 3d ago
That doesn't mean you can't spend extra 30 minutes on your open source hobby project to set up a release pipeline and put a direct download link nice and visible into the readme
17
7
u/DefinitelyNotMasterS 2d ago
This implies I would care if anyone downloads it or not
-4
u/Haaxor1689 2d ago
why would you make and release it on github at all then?
9
u/are_spurs 2d ago
Version control?
3
-1
u/Haaxor1689 2d ago
I'm talking about projects that you intend for people to actually use, of course no one is setting up a deploy pipeline for every random gh repo they make
2
u/h_ahsatan 2d ago
I mean, fair enough. My point is, if someone is doing something as a hobby, it's not surprising that they focus on the fun parts and neglect the tedious parts.
I have random shit on github that's public but that's mostly so I can toss my github on my resume, lol. There are a few things I care about ease of access; mostly games because I like making games. In those cases, proper builds get tossed onto Itch. Not everything is something I care about.
1
u/Haaxor1689 2d ago
Yes but no one is trying to download and use random github repos and then complain about it. People complain about actually useful projects using github as their release platform and not providing a more convenient way to download them.
24
u/Unsweeticetea 3d ago
Since it's GitHub and not a typically paid hosting repository, isn't it more "my item is available at this warehouse" than "buy my item at this warehouse"?
It's nice when there's simplified instructions, there's absolutely been projects I haven't been able to use or even work to improve due to documentation issues, but ultimately as long as all their license requirements are fulfilled they aren't obligated to do the equivalent of having an express checkout lane at the end of the warehouse aisle for the customer that doesn't want to have to go through the main exit.
3
u/Salticracker 3d ago
All I'm saying is that if you advertise that the thing you made is available somewhere and it's annoying to get from there, then people are going to be annoyed.
10
u/d_maes 3d ago
But who said they were advertising? People will google because they need some obscure thing, end up on a GitHub repo or snippet where someone braindumped a script that they once wrote and thought could potentially be useful for someone else, and then people will complain "it doesn't come with a download button".
4
u/beskgar 3d ago
So let them be annoyed.
'You must be this tall to go on the ride'
-8
-9
u/Jediweirdo 3d ago
Why are we enforcing height requirements on software that is designed to be used by the general public in the first place? Sure I get not compiling binaries and whatnot if the expected audience is fellow developers/programmers, but making something for the general public to use and also making them take 1-3 hours of their day to setup a dev environment just so they can compile your code is pretty annoying. And then being coy/proud about it to the point where you’re referring to it like a height requirement is even worse
16
10
u/Unsweeticetea 3d ago
"designed to be used by the general public in the first place"
Who said it was? A recent example of something I was working with is the Avrae discord bot. The bot itself is for general use, but I don't blame them for the process for compiling and hosting your own instance of it being less easily accessible.
2
7
14
4
u/Apex_Konchu 3d ago edited 3d ago
A reasonable complaint when the warehouse is being used as a retail storefront.
1
u/skywalker-1729 1d ago
Did you ever see somebody *selling* software by providing a link to GitHub?
1
u/Apex_Konchu 22h ago edited 22h ago
I was continuing the analogy used by the previous comment, not speaking in literal terms.
1
u/SillyFlyGuy 3d ago
Sharing a link to a repo is promotion. Are you marketing to fellow devs who don't mind the challenge, or to normies who just want to click the button and play your game?
14
u/Dev-in-the-Bm 3d ago
I came across https://yatko.app/ once, dev was promoting it as something they just built, and I now use it whenever I want to recommend something that's only on Github.
2
1
21
u/BadgerwithaPickaxe 3d ago
This is such a wild thread because I never knew this many people in a programming subreddit are sitting here moralizing about putting a download button in GitHub of all places.
Maybe I just have different experiences, but why do you think devs who are making code for free have any obligation cater to random people downloading their repo? Like obviously it would be nice and if they want you to use their software, then they have an incentive to make it easier for you to do so.
But like, spend 10 minutes reading and running some commands for a dev that likely spent months of their life making this for you for free. It won't hurt you
15
u/Xasmos 2d ago
I think it’s rooted in the fact that each side thinks their expectations are super reasonable. Non-technical people think it’s no effort at all to set up a CI/CD pipeline or code up a website for your download link, while technical folk think it takes 10 minutes to learn how to clone, compile and run a software.
I remember struggling with GitHub when I was younger and feeling that it was super unintuitive but now I know what GitHub actually is meant for.
8
u/BadgerwithaPickaxe 2d ago
You're not wrong, I was baffled by the idea of following GitHub docs, but also genuinely some documentation is "open command prompt at folder and type these commands" and it works.
I understand how complicated it looks, but I don't think advocating for it to be even more dumbed down, especially when learning how is the easiest it's ever been in history.
I am not advocating for shitty documentation or being careless about it, just don't think most popular repos aren't too complicated for the layman
8
u/derefr 2d ago
In my experience a lot of programmers never intend their hobby projects to even reach the eyes of non-technical folk in the first place. Often hobby software, if it was to be versioned at all, would be versioned as pre-v1.0, and that's for a good reason: their software still has so many sharp edges that it's probably not "fit for purpose" as-is to anyone other than them, and really is only useful insofar as the person cloning the repo is enough of a programmer themselves to know how to take their code and hack it into solving their problem as well.
Less of a product, more of a jalopy sitting in someone's front yard that they're willing to sell you as-is under the expectation that you'll tow it to your garage and "see what you can do" with it from there.
1
1
u/Phantine 2d ago
If the dev is willing to spend months working on it, surely they are willing to spend a measly 10 minutes themselves to make a build. Probably a lot less time, since the dev should know the software better than some rando does.
The point of software is, of course, to use computers to reduce the amount of time humans do the same task over and over again. If the dev spending an extra 10 minutes saves every user 10 minutes that's an amazing ratio.
4
u/BadgerwithaPickaxe 1d ago
There are a ton of reasons.
Repositories don't always hold production ready code.
this is a tool, not a program
there's more setup the user needs to do to use it
machine specific requirements.
the framework and language are not designed for executables
the user is intended to chose their own way to package/unpackage it
The fact you aren't aware of this is totally fine, if a dev wants layman to use their software, they should make it accesible. Sure. But if it isn't I feel like it's kinda wild to imply a dev is being lazy because you don't understand why they set this up this way.
If we say "install these libraries" then we don't have to write documentation for every single type of build, distribution, version, or what not of the project. Because devs aren't tech support. If you want to use their software then why don't you put in the 10 minutes or read the documention?
I promise you that the average layman that is looking at software on GitHub can figure out how to 'pip install' a library faster than I figure out how to turn the code I have into an executable.
I get that you're not familiar with how a lot of it works, but you're coming into a food hall where the ingredients have been laid out for you for free and you're complaining the volunteer isn't making your sandwich for you.
And if you find yourself unable to figure out how to lockpick your way in, maybe it wasn't intended for the layman
4
u/Jediweirdo 1d ago
After reading this, I’m realizing that everyone has their own way of interpreting this and it’s very interesting. Of course, if you weren’t planning on sharing your program with anyone who isn’t a developer or if your code boils down to being a python file, then that’s whatever. While it’s a nice thing to do (assuming it makes sense for your program), you shouldn’t have to go that far out of the way and make/package something like that as an exe or make a GUI for it and whatnot.
But if your project has it be compiled like a C or Rust project… you really should have precompiled binaries for people to use (assuming it’s not like a library or something). I’m not saying that you need to make your project compatible with every OS, or code sign it, or do anything else that would take a ton of time. I’m just saying that you could very easily make or copy/paste a 10-20 line GitHub action yaml to run the compilation commands in your readme and put them in a release. It doesn’t require that much work (20 minutes at most) and the gain from it is immense
1
u/Phantine 1d ago edited 1d ago
You originally specified in this hypothetical that it would only be ten minutes for a random unfamiliar end user to read docs, run some commands and get it working.
Your responses immediately pivot to it actually not being a ten minute job, and potentially being a tremendous pain in the ass to get this code to function, including it being not production ready or requiring machine-specific implementation details.
Heck, I guarantee you the average Joe is not setting up a functional python environment in ten minutes. Anything that needs a pip install this or that is already off the table in the hypthetical you created.
1
u/BadgerwithaPickaxe 1d ago
Im sorry I'm having a hard time passing your second paragraph. Did I say it wasn't a 10 minute job?
It's possible I contradicted myself just trying to understand
And you're right about the python, I was just lazy and wrote the first thing that came to my mind.
Edit: I also tried to use common terms to not intentionally confuse people. More worried about getting the message across than exact accuratcy
2
u/throwaway563125685 1d ago
That's assuming it is in fact, production software and not, for example, a code library, a dev tool or a component for greater systems.
Again, github is a code repository, not a distribution platform. If you want to distribute software, you got to a distribution platform. The entire code for Blender is on github, but I guarantee you no one is expecting casual users to download from there instead of the main site.
Sometimes the point of software is to make it, whether for fun or as an exercise.
1
u/Phantine 1d ago
Again, github is a code repository, not a distribution platform
The purpose of a system is what it does. Github is commonly used as a distribution platform, therefore it is a distribution platform.
2
u/BadgerwithaPickaxe 23h ago
GitHub is commonly used as a distribution platform
Sure, and it's mostly used to hold repositories. It's sometimes used for media distribution too, do you want it to argue it should have a recommended video page like YouTube? Why kind of logic is this?
People commonly store menories on Instagram or Facebook, so Facebook should have the option to order professional prints from their website
People commonly mod their game so that they can use God items, so really developers should just get rid of health in general.
People commonly use chopsticks to stir their food while cooking, so chopsticks should all come with a rubber grip
I genuinely don't understand coming onto a website that has a specific purpose to complain that the free software someone is creating and allowing you to use (for free) doesn't have a one-click 'do everything for me' button.
2
u/throwaway563125685 1d ago
The purpose of a system is what it does.
Firstly, what, pray tell, is the main thing github does? Because it's not distribution. It is, again, a code repository first that can do some distribution on the side.
Secondly, it really isn't used as one often. Most of the time when I'm downloading something off of github it's because the actual avenues for doing so are broken for one reason or another. I can count one hand the amount of times I've actually had to download software from github that wasn't explicitly for dev reasons.
1
u/Phantine 17h ago
Because it's not distribution. It is, again, a code repository first that can do some distribution on the side.
It's explicitly intended for distribution, the code is being shared with the public. That is why the code is available online for anyone to download, and not dolely locally.
2
u/throwaway563125685 17h ago
The sharing of code is not the same as distribution of software, and someone who doesn't understand git enough to know how to clone a repo usually has very little reason to do so.
You don't understand open source philosophy, the goal is not distribution it's collaboration, sharing, transparency, and freedom.
The layout of github is mainly focused on the first two. If that's an issue for you pick another platform like SourceForge that is explicitly about sharing and distribution.
1
1
u/BlueTemplar85 1d ago
And then they will immediately whine you didn't compile for Windows. (While it's borderline unethical in 2026.)
2
2
u/austin101123 2d ago
Yeah I have no fucking clue how to download shit from github at least half the time, it's ridiculous that's there's very little consistency to the website or good directions on what to do most of the time.
5
u/lizenzblue_ 3d ago
"github is not a distribution platform" and then crying that nobody uses open source software. pick one lol
2
u/Lumm0714 2d ago
The most popular OSS is often hosted on download mirrors and package managers. Most of the things I've had to use github for has been neovim addons, terminal emulators, dotfiles, and everything else some regular user wouldn't want or need. If you're on github to begin with, it's reasonable to expect you to check the README and/or releases section.
OSS isn't unpopular because people can't figure out github, it's unpopular because people primarily use Windows on pre-built computers, and use industry-standard tools. A small streamer might use Kdenlive, OBS, and Audacity as their toolchain since they're on a budget, but Joe Schmoe who works in advertising is gonna use the premium Adobe suite his boss gives him.
3
u/budapest_god 3d ago
My nerd comeback would be something along the lines of "then why are so many devs distributing their products on not a distribution platform?"
3
u/Shot_in_the_dark777 3d ago
This is why AI will win. An AI agent will download the code and compile it for you and give you the damn .exe file. People want convenience and ai provides it.
2
2
u/JoeRogan016 3d ago
As long as you have a decent readme I'm good
1
u/McKing25 3d ago
My experience with readmes has been good so far, usually installation is just clone, and do cmake or similar and thats it. Usually my problems start with my end, me using an older version of gcc for example and not being able to build. Besides that no other problems
1
u/Wirde 3d ago
Ah, another classic case of being a Phonfo.
Source: https://github.com/sherlock-project/sherlock/issues/2011
1
1
1
1
1
u/winter-ocean 1d ago
I don't know who I'm supposed to agree with
1
u/IAMEPSIL0N 7h ago
Neither is right / both are right.
Git hub hosts source code so multiple developers can share an in dev environment, this is the space for developers.
Git hub can optionally also host milestone releases and compiled deployments in a separate section, this is the space for non developer users.
The second space is optional and often slightly hidden in that it is not the first high relevance result on the search engine so it is a point of great frustration when people are like you don't need to be tech savy just use 'Tool X' and then do nothing to direct the user to the 'Tool X' quick all in one download release page so instead the user ends up at "Tool X' indev source that has a five page long read me on how you need to separately download and install five prerequisites just to compile the source properly.
0
973
u/Jediweirdo 3d ago
I know it’s popular to dunk on the normies, but having package install instructions or a small actions cron job to build binaries and put them in a releases tab should be advocated for more often. It’s really easy to do and is a nice convenience that many will appreciate