r/github • • Feb 24 '24

The reality of the Github exe (meme) problem

I'm sure you have seen the memes. Some people are enjoying the ride while others are taking it quite seriously.

There is a legitimate issue here. But most people are arguing past it.

Github as we all know is a platform for developers to maintain a codebase. It's not a platform intended for distribution to end users (unless said users are also developers). However, some developers are using Github as a distribution solution, and sometimes the only "official" means to access their software. It's not even uncommon, in my personal experience. The experience can be baffling for would-be end users as the website is not designed to point them towards anything they can understand.

This is a total usability failure. But the failure isn't Github, per se. Perhaps it's more accurate to say it's a failure on the part of the developers who haven't provided an appropriately accessible means to download their software.

On the other hand, it is entirely possible to share executables on the platform. There is a page dedicated to releases. And having both the executable and the source code in one location/platform really doesn't seem like a bad idea. It would not be hard at all for Github to improve the accessibility for end-users massively with small website changes, maybe make the "Releases" section much more prominent, that kind of thing.

Here's my question to you:
Should Github be useful as a platform for distributing executables to end-users or not?

I would love to see Github step up and realize how much of a difference they could make in this area for a lot of people just by moving things around a little on their website. But if you think the site shouldn't be used that way at all, then do we start telling devs to cut it out and upload their software somewhere else for distribution, or what?

485 Upvotes

143 comments sorted by

197

u/[deleted] Feb 24 '24

So part of the problem with this conversation is that there is a whole lot of software built on GitHub cannot be put in binaries. Software libraries are not executables for a reason. Building out another feature set that would not apply for a large percentage of projects, just to cater to a few people who aren't even making an account, just doesn't make sense to me.

I do not want GitHub to bloat its service by adding in more features that are outside its core mission and would not be used by the vast majority of its user base. What I would support is a GitHub-connected service that makes it easy to upload and distribute binaries. App stores exist for a reason.

54

u/jonnyman9 Feb 24 '24

Amen! That’s why we have PyPI or RubyGems or Maven Central or npmjs or CPAN or NuGet or Hex or Crates. I like that GitHub is so focused on the code aspect. Let other platforms handle the other stuff.

-20

u/-PHI- Feb 24 '24

Is there a problem with people asking for binaries of things that can't be binaries? It seems like a separate issue if it is one.

49

u/[deleted] Feb 24 '24

No there’s not, but you’re proposing changing the UI for a use case that doesn’t apply to a huge fraction of projects. We use package managers to get software libraries, not GitHub releases.

Let GitHub focus on its primary mission: collaborative software development. Let app stores focus on their primary mission: distribution to end users. They’re two very different things. I’d rather the respective teams focus on what they’re good at.

5

u/phaj19 Feb 25 '24

Would it slow you down massively if there was some download button available? And you could have the option to turn it off.

-12

u/-PHI- Feb 25 '24

So your belief is that people shouldn't use GitHub to distribute software to end users?

26

u/[deleted] Feb 25 '24

Yes. That is my belief.

Let's build really amazing services for distributing software to end users. Let's build really amazing services for developers to develop software collaboratively. Let's even build really amazing services that connect them.

There's no reason for them to all be in one place.

17

u/-PHI- Feb 25 '24

I can agree with that. 👍

1

u/corvus_corax_19pr Feb 25 '24

I got into foss,privatcy , piracy etc and github is like the linchpin. I had to use it for at least a majority of the time to download,searchand update software.

1

u/Cynyr36 Feb 26 '24

Imo, distribution to end users is for the distributions. Maybe something like chocolatly on windows. Personally I'm pretty tired of "curl ${url} | sudo bash" or "docker start foo" being the only options for so many things.

6

u/Moscato359 Feb 25 '24

I really don't think github should be used to distribute software to end users

It's a system to help facilitate building software, not releasing software

1

u/[deleted] Feb 25 '24

Really can't wait for software development to become almost obsolete like blacksmithing is today only reserved for enthusiasts.

2

u/Moscato359 Feb 25 '24

Software development's core issue isn't actually writing code, it's figuring out what code needs to be written

That's fundamentally different than blacksmithing, as blacksmithing is the manual creation of a product, while engineering would be designing the product to be created

0

u/[deleted] Feb 25 '24

Are you sure about that, "fundamental" differences? Blaksmithing can take also form of art and also require blacksmith to concieve or even design tool before or during actual labour? For most of professions even repetitive one at it's core usually not much different from engeneering. Same could be said for bread making, legal clerks or even making an art... You should read some Marx believe me 😅

2

u/Moscato359 Feb 25 '24

Designing a bread recipe, and bread maker is closer to software engineering, than making bread is

Blacksmiths doesn't have to conceive how to make a sword if the smith already made 50 swords

And they don't have to conceive how to make one, if they were told how to make one

Making the recipe, and the manufacturing process is engineering

I'm a software engineer, and what I work on changes ever few days

Manufacturing jobs don't work that way

1

u/[deleted] Feb 25 '24

Blacksmithing or bread making aren't manufacturing jobs (in modern sens of that word), artisan work would be a better term. And thus I think you're right it's different more I think now it's more sofisticated then engeneering.

→ More replies (0)

2

u/Shitman2000 Feb 25 '24

Yes, that was the case in the original post that sparked the meme.

Some unhinged dude wanted the binary for a tool called "Sherlock", which was a cli tool with no ui. (Okay, technically you could make it a binary, but it still wouldn't be usable for end-users)

0

u/-PHI- Feb 25 '24

That's good to know. I think it comes down to being a communication issue.

8

u/PlsNoBanAgainQQ Feb 25 '24

The problem is people (like you) are asking for things they don't fully understand. Developers don't owe you anything. If you're not capable of compiling from source code then you probably have no business using the software.

71

u/mrbmi513 Feb 24 '24

A GitHub repo page itself shouldn't be a distribution mechanism. Developers should use Pages to describe the project and link to the release.

2

u/-PHI- Feb 24 '24

Could you perhaps link to any good examples of this?

9

u/passcod Feb 24 '24 edited Jan 01 '25

workable dazzling compare selective paltry physical ruthless materialistic weather unique

This post was mass deleted and anonymized with Redact

8

u/MoridinB Feb 25 '24

I want to point out how satisfyingly perfect this example is. It's a blog post for a release of an open source project complete with a link to download the project, and the project itself is about how to create a nice site for the end user. Neat!

1

u/SamTV98 Feb 24 '24

We have a download section that shows the different icons so it is really the user clicks on the link, exe downloads from GitHub releases: https://etherpad.org/

0

u/Dotkor_Johannessen Feb 24 '24

What should be the distribution mechanism? Remember, it could be an open source project without any money. You got any ideas?

21

u/mrbmi513 Feb 24 '24

Turn on Pages, use the github.io URL, and make that page user friendly. Costs nothing more than a few minutes of time.

7

u/wrongontheinternet Feb 25 '24

That's literally what the project referenced by the original post did. Just, the shiny installation button on the site links to the installation instructions in the repo's README instead of to any sort of download.

Which is kinda what confuses me, actually. What's the point of only going halfway like this? Do you want to distribute your software or not?

13

u/mrbmi513 Feb 25 '24

That project is a python project, which can be packaged into an executable, but traditionally shipped like this for more hobbyist software.

-1

u/wrongontheinternet Feb 25 '24

Yeah, I understand that. I'm pointing more to the discrepancy between how friendly it looks on the surface versus when you go to actually do anything with it. The fact that it can be packaged leads me to believe they should just do it, or drop the whole pretense because they clearly don't want to actually distribute their software (the comments on the issue posted to the project about making an EXE are telling)

And that's putting aside that it's probably not a great idea to pip install into the base/system python when you should probably be using a venv or some sort of separation (especially for OS's where the python they come installed with is "load bearing").

11

u/D0nt3v3nA5k Feb 25 '24

just because it can be packaged doesn’t mean it should be, there are reasons why python programs are almost never distributed as executables. firstly, there’s the issue of file size, the python file itself that could only take a few megabytes at most, but to compile it down to an executable, you would have to not only compile down the python interpreter and the python file itself, but also ANY dependencies you use for that python file, resulting in an unnecessarily large executable file. second is accessibility, many people thinks distributing executables is more accessible than distributing source code for python, that’s not the case most of the times. executables are not only OS dependent, but they are also architecture dependent, you not only have to make sure it works for linux, mac, and windows. you also have to make sure it work with x86, ARM64, etc for all of the respective operating systems, thats a huge hit on accessibility compared to a python file that is able to run on any platform with the appropriate python version installed. so compiling an executable for this project is literally more trouble than it is worth. (not to mention sherlock is literally a CLI program, so if they don’t understand how to install python, they won’t understand how to use it)

3

u/mrbmi513 Feb 25 '24

If the button was "Download," I'd agree with you, but it's not.

-1

u/wrongontheinternet Feb 25 '24 edited Feb 25 '24

Fair point, and one I wish more people would talk about instead of just posting endless memes about the whole thing. Like yeah, the original poster was cracked and we probably all dodged a bullet but maybe there were some kernels of truth in the whole rant?

EDIT: I say this also because as a developer I've sometimes wanted to find simple tools to solve simple problems and find the correct thing, only to realize there are no binaries, no instructions, and it probably doesn't build on anything except a specific flavor of Linux, maybe, if your dependencies are good. I don't want to start a new hobby project I just want to solve my problem.

-1

u/szank Feb 25 '24

So you want to gatekeep github to projects that must run on windows, Linux, amd64 and arm macos, frebsd, openbsd, and what else? Because if it works only on one flavour of Linux that the dev used to create it it's wrong and should be banned?

Why ?

0

u/wrongontheinternet Feb 25 '24

I didn't say that. All I said is that if you don't want to do all that, don't use existing features of the platform to make it look like you might. Create expectations consistent with what you want to deliver so that people don't get frustrated. I'm not the one who wrote the site and published it. When my repos are just little toy projects I treat them as such. Why create headaches for others and yourself by having mismatched expectations?

→ More replies (0)

0

u/burritolittledonkey Feb 26 '24

Sherlock is a CLI tool. Even if it was packaged - how would an end user use it? There’s no GUI

The software is not intended for end users, full stop

2

u/wrongontheinternet Feb 26 '24 edited Feb 27 '24

I've used a number of CLI tools that are just "this is a binary and you put it in your PATH" which is about as easy as distributing a CLI tool can get outside of using an OS package manager. A couple of examples off the top of my head are youtube-dl and ffmpeg.

Just because it's a CLI tool doesn't mean we have to 100% cease caring about ease of use.

EDIT: also, just to drive the point further, I'm pretty sure youtube-dl is written in Python.

17

u/Relevant_Pause_7593 Feb 24 '24

There is just too much going on for causal users- you’d need a whole different ui without all the non developer things- and at that stage it is easier for the developers to create a portal or even a Wordpress site and link to the releases page or even the exe directly.

-11

u/-PHI- Feb 24 '24

That's reasonable but I don't entirely agree. I think if the goal was to help people unfamiliar with Github to find where to download a release, all you need to do is make it so they can easily find that (visually) on the page. They will naturally ignore everything else. It's a very simple thing to address from a design perspective.

15

u/Relevant_Pause_7593 Feb 24 '24

But it’s changing the point of GitHub. There are so many tabs and links -all directed at the developer. Because of a couple end users we are going to handicap the developer experience?

1

u/-PHI- Feb 24 '24

Github already has a page for releases, and even a link to it on the main page of the repository. It's just too hard for people to find. It would be simple to move this to some where more visible. That alone would be a big improvement.

4

u/tobiasvl Feb 25 '24

But releases aren't always binary downloads. They can be, but not necessarily.

If the repo owner wants to bring attention to the releases, they can point to them in the readme, or build their own github pages website that links directly to the release binaries.

18

u/[deleted] Feb 24 '24

I dont agree with using the releases as distribution for executable. If you do so, you have to compile for multiple platforms and versions.

Github is meant for sharing and collaborating with other developers, NOT distributing scripts consumers.

2

u/-PHI- Feb 25 '24

So in your opinion the developers who are using GitHub to distribute to end users shouldn't do that?

10

u/armahillo Feb 25 '24

it is perhaps an unwise use of the platform (for the reasons you cited) and that should not be made a first class feature.

If github wants to make a parallel site “apphub” or whatever, and create a pipeline that connects the two, that might be one way to handle this.

I dont go to factories and complain that theres no storefront to buy the goods.

If a repo maintainer intends for the general public to be the audience for their product, its their responsibility to make that clearly available. Dont make our work harder by trying to make the site serve multiple roles.

6

u/-PHI- Feb 25 '24

I dont go to factories and complain that theres no storefront to buy the goods.

I don't think the users we're talking about want to end up on GitHub when they're looking to access a piece of software.

So they are justified in complaining if developers don't provide a good download path outside of GitHub, no?

3

u/armahillo Feb 25 '24

Idk

Sometimes it seems like users want things to be handed to them instead of learning how to do a thing. Having barriers of entry that impose learning requrements can be a good thing. Like if its a command line program that has complicated command line switches and such, you can make it easier to download the binary, but is that going to lead to an immediate complaint that they dont know how to use it?

It ultimately depends what the program is, i guess.

3

u/-PHI- Feb 25 '24

I can agree with that to a degree. If your program is absolutely not intended to be used by people without a software developer skillset then you don't need to cater to them. If that's not the case though, well I think it's good to have respect for people's time.

2

u/armahillo Feb 25 '24

i have seen this meme appear unironically for things like “rip youtube from url” — very much the “skript kiddie” audience doing the complaining. “git gud” tends to be my immediate thought in those cases 🤷‍♂️

really its up to the devs - are they ok with fewer people using it because its harder to acquire?

2

u/kuskoman Feb 25 '24

in multiple projects adding another target is just a few lines of code. for example in this project: https://github.com/kuskoman/logstash-exporter/releases/tag/v2.0.0-pre3 i currently have support for macos, windows, linux amd and linux arm, but adding another one should be a very simple (thanks to golang compiler. the situation may vary depending on used language/toolkit). and there are some really big companies using binary releases from this repo as their main pipeline of getting the application

3

u/glasket_ Feb 25 '24

I dont agree with using the releases as distribution for executable. If you do so, you have to compile for multiple platforms and versions.

Huh? You can compile for a single platform if you want. There isn't a stipulation that says you have to support all platforms in order to add binaries to a release.

Github is meant for sharing and collaborating with other developers, NOT distributing scripts consumers.

GitHub's primary purpose is to be a git server, but it also has other purposes like project coordination, collaborative coding, or, via releases, distribution of precompiled applications. Things can have more than a single purpose.

24

u/SexyMuon Feb 25 '24

I think the developers are free to do whatever the fuck they want to do, and if the user can't setup a simple environment or can't install the requirements, then that's too bad fucking bad for them. Why are we still talking about that shitpost anyway?

1

u/-PHI- Feb 25 '24

Of course people are free to do what they want. This isn't a matter of rights and freedoms. It's a design issue. Since when are we against communicating good practices?

8

u/seimmuc_ Feb 25 '24 edited Feb 25 '24

Since there is no design issue. Any further attempt to make GitHub more accessible to people who just want binaries will make the experience worse for its core users. From something as small as buttons taking up valuable space on the repo page, to major things like people getting the impression that GitHub is a software distribution platform and opening issues asking why some web server project or some simple shell script repo doesn't have a downloadable executable. Sometimes gatekeeping is actually a good thing. The cool thing about GitHub is that it already gives developers many optional tools to distribute their software in a user friendly way. Devs can link directly to the repo's release page or even directly to specific file downloads from the latest release. They can post those links in the Readme file, on their own site, or on their GitHub Pages site. They can link to their own site or GitHub Pages on the right side right under the project description. If that isn't user friendly enough for someone, that person should not be on GitHub in the first place.

-2

u/PurpleTieflingBard Feb 25 '24 edited Feb 25 '24

Why is it okay to have this mentality for launch but not for bugtesting?

When developing, you need the mentality of "assume the user is stupid." But for launch it's "let the user figure it out."

If it's bad practice for code to be breakable through user incompetence, it's bad practice if code is not executable by user incompetence

Also, it's not like this is a problem unique to non-programming users, I know tons of developers who has struggled to use a tool because the dev stopped working on it 2 years ago and half the requirements they used have been updated to not work with oneanother and the other half are also either abandoned or they have changed. Sure the devs typically work it out but it's just wasted time. (Especially when requirements.txt doesn't include the version you need to install)

I remember an entire workweek was spent trying to get some old computer vision code working and the error was that between dependency versions a folder had been renamed.

Sure the dev doesn't owe anyone anything and they're free to move on from a project, but to pretend it's just an issue with lazy non programmers wanting software spoonfed to them is wrong

2

u/apnorton Feb 26 '24

Why is it okay to have this mentality for launch but not for bugtesting?

When developing, you need the mentality of "assume the user is stupid." But for launch it's "let the user figure it out."

We don't "assume the user is stupid" when bug testing just for its own sake --- instead, we're trying to ensure the correctness of the program regardless of input. We assume the user may put wrong input into the program because, if the program allows bad input in without catching it, that's a correctness issue.

If the user can't figure out how to install/launch/link/whatever-deployment-mechanism-is-used the program, that's not an issue with correctness; that's just a PEBKAC issue.

8

u/Sweet_Computer_7116 Feb 25 '24

My take: just because some people use and advocate using airplane bathrooms to have sex, it doesn't mean it's the airlines job to make it a comforting experience.

Github is the bathroom in this scenario. While most people around are sitting in the toilet (devs). Some are screwing on it (users thinking it is software distribution software). And the influences advocating to screw in it. (The devs using it to distribute software)... And the ones screwing in there are complaining it's difficult to do just that... demanding that every airline should have comfortable screw bathrooms...

-1

u/-PHI- Feb 25 '24

So would it be better if devs didn't use it for distribution? Nobody seems to want to say that. 😄

4

u/Sweet_Computer_7116 Feb 25 '24

No. That's the thing is completely up to them and their choice.

4

u/-PHI- Feb 25 '24

So is there a better choice and a worse choice? No one is talking about rounding people up and locking them away. Aren't good and bad practices a part of software development? Do we not have standards?

7

u/Sweet_Computer_7116 Feb 25 '24

It's a simple equation. Let me simplify the course of action.

Let those who crap in the bathroom crap in it.

Let those who screw in it screw in it.

Those who call for airlines to turn the bathroom into a pleasure Palace. Should fuck right off.. harshly put.

Don't try and look to deep at this situation. You're dealing with people too lazy to even read up about what github is for then complaining it isn't.

3

u/-PHI- Feb 25 '24

I don't need to try to look deep into it. I've been on both ends of the situation, or at least as far as to say I have used GitHub myself, and at other times I've also experienced being deeply frustrated at how impermeable it is when trying to access a piece of software, especially when you're already dealing with other problems and looking for solutions. Many people have experienced this.

The interesting thing about this reddit thread is it's addressing people who aren't directly affected by this problem. They have no reason to care, it seems. I was fascinated when this problem was suddenly brought into the limelight in some small way because I had experienced this atrocious usability issue multiple times in the past and completely understand the frustration other people have expressed around this that they probably had no outlet for in the past. It's fascinating seeing the apparent disconnect between developers and non developers. And I feel like people should pay attention to it. It's real and turning a blind eye to it is the real dumbing down and being lazy. It's interesting. It's worth talking about. It's worth understanding.

8

u/Sweet_Computer_7116 Feb 25 '24

Developers have already addressed this disconnect. There are literal app stores on every platform.

Girhub is a developer tool.

To use a developer tool you'll require some developer knowledge.

The problem is mostly likely laziness/unwillingness to self educate. Which is solved by self education. Something only the problem solver can do.

Most devs on github keep very clear and simple readme files so you can use their tool.

7

u/szank Feb 24 '24

You are expecting developers to maintain installers for platform they don't necessarily use, eh ?

Say, why would you put an expectation to give out a windows exe file to someone who haven't touched windows in the last 10 years ? (For the record, I use windows, but don't code on windows).

I have said it in the other threads on this topic but I'll repeat myself. The code comes as is. Take it or leave it. There's no expectations or obligations attached to it.

Hell, the code might be broken or just randomly wipe your hard drive because of a typo and again, it's on the user to have backups.

Yeah, sure one can provide release binaries. If one can be bothered. If not then use linux and grab the code from the distro repository. Usually popular tools are packaged nicely.

Same for mac and homebrew.

1

u/-PHI- Feb 24 '24

If you have no interest in providing an accessible release or even working code then don't. No one is making you do that. If you actually want to make something usable to the broader public then that's different.

1

u/szank Feb 25 '24

Author of whatever project thar sparked the whole discussion by not providing the compiled exe is clearly not interested in making their software usable to the broader public , because they didn't create an exe.

So basically you've killed the discussion you've started here with this reply. They didn't, so they didn't. What's the deal here ? Karma farming by jumping on this bandwagon ?

49

u/centur Feb 24 '24

I'd say - no, please dont. It is actually a bad situation when a viable tool for professionals bending under "public" pressure into something more inclusive and more available to"everyone". There are solid reasons specialized tools and machinery to built differently than "popular" ones, they perform better that way. And making it friendly to those who don't care (and dude doesn't care, he just wants an exe from smelly nerds) not only brings unreasonable demands from no-cluers, it degrades quality for professionals who uses it daily. So they will start leaving in favour of a better tool or place or community (referential example if you need one is StackOverflow - in early days it was a place of joy and knowledge and I forgot when I logged in there last time or when I used any answers from it - it just mostly rubbish and I'll be better finding answer in docs now, than there).

4

u/Destrodom Feb 25 '24

So you saying that if you have a product that focuses on specific target audience and their requirements, this product loses part of its value when it tries to open up and become more accessible to general audience - majority of which is almost completely unrelated to the original target audience? Color me shocked! Shocked! Well, not that shocked. If only other companies realized this as well. Accessibility is a nice value, but addiding it everywhere you can doesn't automatically make a product better.

3

u/Noch_ein_Kamel Feb 24 '24

Github as we all know is a platform for developers to maintain a codebase. It's not a platform intended for distribution to end users

How do you know how it's intended to be used? Are you Scott Chacon?

Heck the github getting started documentation starts with

Learn how to start building, shipping, and maintaining software with GitHub

And there is no need to tell any dev anything. They can do as they want.

0

u/-PHI- Feb 24 '24

How do you know how it's intended to be used?

By how it's designed.
If you think it should be (optionally) used to distribute programs to end-users then that's what I'm curious to know. Because it's not currently designed well for that, and it doesn't seem like people agree on that.

2

u/elvisap Feb 25 '24

Should Github be useful as a platform for distributing executables to end-users or not?

What's the project? Who are the end users?

So much nuance to consider here. There's no chance you can give a simple yes/no answer to a question like this across the near infinite diversity of projects and people within such a broad scope.

0

u/-PHI- Feb 25 '24

Sure you can. The operative word is "useful," i.e. it could be used or not used, but if you're going to use it hopefully it does the job well.

1

u/szank Feb 25 '24

It's not useful for this because there are already many, many much better projects used to distribute software to the end users. Namely apt, dnf, yum, homebred, macports and thelike. Tailored to the operating system used by the end user and working very well.

Used to distribute projects not only from github but many other places also.

Maintained by people who care about making the software available to as many users as possible.

Just use that, like anyone else. The upside is that the people packaging the software make sure it works for the platform they are packaging it for. The upside is that they've got expertise with supporting their platform, so that the devoted doesn't need to become an expert in supporting all of the exiting systems out there.

These people are often also devs and sometimes maintain their own set of patches on top of the upstream code that makes the software work better on their own platform that are too unique/specific to make it to upstream repo.

11

u/bschlueter Feb 25 '24

Github provides a way for devs to host websites. Maybe I expect too much from my fellow developers, but if you expect lay people to use your software, building a documentation and distribution site with Jekyll is not that hard.

Perhaps the problem is that the devs don't expect lay people to use their software, which seems like a legitimate reason to not attempt to do better to make their software accessible. Even AWS realizes that lay users are the most demanding users and that's why engineers who know AWS get paid well.

7

u/Victorioxd Feb 25 '24

Yeah, there is a more end user friendly download page, it's called GH pages, lots of projects use a gh page (or their own website) to have the big "DOWNLOAD" button and it works well enough.

If you mean like a software marketplace, I don't think GitHub is the right website for doing that, I mean I do it, I usually scroll GitHub for interesting repos when I'm bored but for non programmers...

9

u/[deleted] Feb 24 '24

app stores and package managers exist for a reason.

1

u/G1veyouUpAstley Jun 07 '25

well then get end-user developers to fucking post them there.

3

u/SkippyNBS Feb 25 '24

If people want to use their Github as a distribution page, it’s on them to set up a nice README. I’ve seen repositories that mimic most software distribution websites (Python, Unreal engine, OBS Studio, etc) by having a giant “Download” link in their README.

The link just goes to the releases tab or something similar, but everyone sees the README when they go to a repository. By formatting the README properly, Github works totally fine for distribution without any new features

9

u/glasket_ Feb 25 '24

It's weird seeing so many people saying GitHub isn't for distribution, as if the releases tab is just for fun or something. This is from the About releases support page:

Releases are deployable software iterations you can package and make available for a wider audience to download and use.

Like it's fine if you don't want to distribute on GitHub, or if you want to make a custom page for it, or if you just don't want to distribute at all, but it's kind of annoying seeing so many people saying a common practice shouldn't be done.

5

u/[deleted] Feb 25 '24

This is manufactured and not a real issue. Please do not push this narrative. GitHub is not a app store. It is a collaborative version control system with devops capabilities.

2

u/wrongontheinternet Feb 25 '24 edited Feb 25 '24

A lot of people have mentioned "you can make a GitHub Pages site and put a button on it to installation instructions" without mentioning that's _exactly_ what sherlock-project does, except that their shiny "Installation" button just goes to an anchor in the README.md with the instructions to clone the repo and run pip install.

I don't have a good sense of whether or not sherlock considers itself a "hobbyist" project but if you go to the trouble of having a nice looking GitHub Page to attract users and direct them to your install instructions, maybe it'd make sense to go to the trouble of building binaries? Everyone can feel free to agree or disagree on that but in my humble opinion, it feels like going halfway to have a nice GH page up front and then just drop the user on your repo.

I believe that the original OP was absolutely a crazy person and we've probably all dodged a bullet, collectively, but I think there's room here to discuss how GitHub being a "defacto" platform for hosting a lot of software (both code and releases/binaries) means that sometimes it's frustrating when something looks friendly up front and then just kinda dumps you in the middle of something you don't understand the moment you press the shiny "I want this!" button.

Given some of the comments in the [recent GitHub issue requesting a binary release](https://github.com/sherlock-project/sherlock/issues/2006), it seems like maybe they don't actually want to be that friendly, so maybe they could just drop the GH page and save a bit of headache.

4

u/szank Feb 25 '24

If the authors cared about people not being able to run a terminal command as their end users then they'd solve the problem in 100 different ways. Clearly they don't. Even if "download the latest release binary for your operating system" was a button taking half of the screen after opening a project page it wouldn't change anything if the devs weren't bothered to build the binaries.

1

u/wrongontheinternet Feb 25 '24

Actually, I was looking through issues in the project and I found one from about 5 years ago where someone asked (much more politely) for binaries and a maintainer replied something to the effect of "yeah, we'd like to do that but the refactoring to get our project to be something we could put on PyPi is a bit much to handle right now, but feel free to send a pull request." (https://github.com/sherlock-project/sherlock/issues/273#issuecomment-513528700)

So actually when you dig deeper there's evidence that at some point they at least cared enough not to dismiss the idea out of hand and certainly didn't ridicule the person who asked for it. It was an interesting discovery for me as I was doing my research on how this whole meme got started.

4

u/szank Feb 25 '24

I don't feel like anyone is ridiculing people asking questions. On the other hand I am ready to ridicule anyone expecting/demanding end user support from an open source project.

A lot of peoject offer some kind of support, but no one is entitled to it. And by support I also mean anything from providing windows binaries to readme to consistent variable naming .

The whole assumption that the project maintainer wants to reach the widest audience possible and should cater to the widest audience possible is ridiculous to me.

"If you cannot use pip then this is not for you" or just plain "no" when asked about installers is not rude or it doesn't mean that the developers are looking down on the person asking. It's just means "no".

2

u/GeoMap73 Feb 25 '24

I'd say the releases page is already enough. Any proper developer should be able to follow quality instructions to compile a project himself

2

u/EggyRepublic Feb 25 '24

I think GitHub repos should have the option of serving final products. The "releases" section does not have to be visible or used for all repos, it can be enabled only if you choose to. If you don't want to use it, then don't use it. I think it's stupid to tell others this feature shouldn't exist when it clearly has a use case. Not everyone who distributes software wants to make their own personal site.

OP is just saying make the releases section more clear, I literally didn't know it existed until someone pointed it out to me. A change in color might be all that is needed.

4

u/patmorgan235 Feb 25 '24

No, GitHub is a developer platform. They already have the GitHub Pages feature developers can use to host a simple website to give their users installation instructions.

3

u/io-x Feb 25 '24

What's the alternative here? Remove all code files and readme, instead just display a big download now button, because it confuses end users?

3

u/purple_editor_ Feb 25 '24

Not everything need to be for everyone. Not everything is a democracy.

GitHub is a company and they have a vision and should continue to work on that. What an internet stranger know about it? Nada

A repository should not conform to abitrary rules like that. Hell if the developer wants you to solve a puzzle to find out a password to unlock its system, that is their land and their rules

Anything else is people with too much free time and that like to create problems where none exist. It was much better when it was all about code honestly

3

u/ordinarytrespasser Feb 25 '24

No, GitHub is not an app store. Developers that use Github should stick to just uploading their source code/libraries. Also the meme is 100% on the guy's fault, OSINT tools are NOT for unknowledgeable end-users.

2

u/dartwingduck Feb 25 '24

Not sure if serious. I’ve seen the meme too.

GitHub by and large I thought was everyone from mega corporate entities to hobbyist programmers. If a corp doesn’t share their code in an easy to consume manner then I assume they’d lose customers (a big no-no to the engagement metrics)

Assuming a hobbyist or group of hobbyist programmers are held to the same standard is just user entitlement: it’s saying I want to use your work but only on my terms. For me that just means it’s the wrong customer, a stereotypical “Karen.”

We all do it one way or another so it’s understandable but assuming that more software will solve an inherently human problem is folly. The user in the meme wasn’t going to go out of their way to learn how to install and use the tool in question, why do you think an exe magically solve things?

2

u/Imnotchucknorris Feb 25 '24

Should Github be useful as a platform for distributing executables to end-users or not?

They could, but at what incentives? Github are mostly funded by enterprise and premium users, not the end users. If they want their software to be used by common folk, they will set it up on their own website. Because they want their software associate with their own name/company.

Perhaps it's more accurate to say it's a failure on the part of the developers who haven't provided an appropriately accessible means to download their software.

It's not a failure if the original dev doesn't bother to set up binaries release no? There are also no incentives for the dev to provide an easy download button. Some dev with kindness in their hearts will set up the release page, but not everyone.

Maybe, rather than you make a post here, probably start to make a pr to your favourite project and help them automate their release.

Tldr: both dev or GitHub itself doesn't have motivation or incentive to make it easier for the end user.

1

u/[deleted] Dec 16 '24

everyone here is legit out of touch with not just casual users, but other developers as well

Github IS used as a software distribution site, is it meant to be used that way? No, doesn't matter? NO, it doesn't matter at all, it'll forever be used like that by many developers, and not all of them have a page dedicated to normies, sometimes the releases tab isn't even visible and you have to enter the url manually

Having to download automated builds is even worse, some softwares like freetube take too long to release stable builds and you have to make a github account to get the nightly builds, which is simply not end-user friendly at all

1

u/meyriley04 Feb 25 '24

If the developer is using their repository page to show their releases, installation instructions should be detailed and in the readme. I push my releases to the Releases page often, but each of my friends have asked me at least once “where’s the download button” when I share the repo link with them. Devs should maybe just share the Releases page instead

1

u/olddev-jobhunt Feb 25 '24

I got my start as an end user trying to use things. It was frustrating, and even more so back in the 90s. So I have some sympathy.

But also, we're probably not talking about commercial software. We're talking about largely open source volunteer efforts. We can say things like "users need some handholding" and "no one will use your software if they can't figure out how to install it." And those things are true! And at the same time, if it's being maintained by one dude who's stealing an hour here and there out of his weekend to build the thing, that person probably doesn't have the spare capacity to make everything perfectly newb-friendly. That's just the reality of the situation.

So the question of "Should Github be useful for end-users" isn't a yes/no question. I mean, being useful is better than not being useful, but that aint free.

1

u/Arts_Prodigy Feb 25 '24

No we shouldn’t change a platform designed first developers to meet the needs of possible end users.

You don’t turn a CLI into an executable just because an end user might decide they want to use it. You gotta learn how to use the tool as intended if that’s what you want.

1

u/inglandation Feb 25 '24

The meme was funny but it’s a real problem. Before becoming a developer I would often end up on some random repo and have no real idea about what I had to do.

It sometimes still happens…

1

u/jayerp Feb 25 '24

If you want the fully built software, build it yourself.

1

u/MMORPGnews Feb 25 '24

Some software creators just lie about how "great" their software and create "hard" ways to install it.  Even if they can easy make it literally one button install.  

I installed one such "great" software and there was a small community because of how complicated it was compared to alternatives. 

After I set everything and started to use unique features, I found that nothing was working except basic. So called unique features was a lie and dev just named them like that. 

In the end I end up writing myself plugins that create what I need. Overall soft was working.

1

u/MMORPGnews Feb 25 '24

1 year later several alternative soft appeared on github and they all was 1 button install. 

1

u/legendary_anon Feb 25 '24

I'd rather github change nothing. Not because I want to gatekeep, but because that's not what github meant to be in the first place. End of story.

1

u/jon27383838 Feb 25 '24

I’m definitely biased as a developer, but if you’re making software for free and someone decides they would rather complain than just learn to install something you spent time documenting how to do they can go fuck themselves and pay to use the properietary software theyre trying to avoid.

1

u/SeventhDisaster Feb 25 '24

IMO; let specialized software stay specialized software. Turning Github into an actual distribution platform does not sound like a good idea.

I feel like it would both cause problems in the existing experience for developers by taking up space or cluttering it with features not useful to us, as well as potentially other problems by drastically increasing the incoming traffic as end users start flooding the site to get software.

1

u/iogamesplayer Feb 25 '24

just add an exe generator!

1

u/BloodFeastMan Feb 25 '24

Most of the people that argue this point and related points fail to recognize that normies are directed to Github all the time by search engines when they're looking for some type of software to download, _that's_ a big part of the problem.

1

u/Luneriazz Feb 26 '24

well its up to the developer if they want to provide compiled or executables version to to the end-users. but for me its should not mandatory. its still cost time and resource to provide the executeable version.
core of github itself is remote server for version control, making it like appstore would not add very much value and people not always store code and binary in there. document, pdf, picture, python IPYNB, some wierd private document and many more

1

u/amihir Feb 26 '24

May I know some views on Sourceforge? 🤔

In my early age (around year 2013-15), I often downloaded software from there & it has a couple of mirror links to download the setup file.

These days I hardly hear any news about it🤔

1

u/Immistyer Feb 26 '24

I mainly use Github to download software/mods if they’re exclusive to Github, so it’s genuinely annoying when it is made hard.

1

u/trutheality Feb 27 '24

GitHub is a useful platform for distributing executables to users. You just need to use the "releases" features correctly, and if you're not lazy, take 10 minutes to make a GitHub pages website to point the dumbest of your users to download links.

1

u/fixitfeliks Feb 28 '24

These memes are fresh as fuck and funny as hell. GitHub is for development it’s not a build or artifact server.

Even the dev who wrote the code couldn’t get you an exe since it prob only runs on their machine.

1

u/Chenzhiy Feb 28 '24

Is the original post still there?

1

u/wizardeverybit Feb 25 '24 edited Mar 30 '24

I DONT GIVE A FK ABOUT THE FKING CODE! i just want to download this stupid fking application and use it https://github.com/sherlock-project/sherlock#installation

WHY IS THERE CODE??? MAKE A FKING .EXE FILE AND GIVE IT TO ME. these dumbfks think that everyone is a developer and understands code. well i am not and i don't understand it. I only know to download and install applications. SO WHY THE FK IS THERE CODE? make an EXE file and give it to me. STUPID FKING SMELLY NERDS!

1

u/Puzzleheaded-Key-450 Feb 25 '24

Lets be real a second. 99.9999% of github repos non-programmers will never have any desire to use. The Sherlock library only came up because the normies want to cyber stalk each other. It’s some jealous boyfriend googling how to find every social media account of someone.

So no I don’t think we should add more feature bloat to GitHub to help cyberstalkers. I am sure someone already pilfered the code made a website around it then added a bunch of fake loading screens before the 59.95 monthly subscription screen shows up.

1

u/Delerio11 Feb 25 '24

I don’t code. Never have, will maybe learn in the future. However, GitHub has taught me so much when I find something that doesn’t simply have an exe. Everything I learned about running Python has come from YouTube / GitHub. The people who legitimately complain about things not having an .exe are more than capable of learning how to get it to work anyway.

1

u/Doodah249 Feb 25 '24

It all boils down to the fact that people refuse to use a proper package manager. MICHAEL ORLITZKY describes in well in his nsfw blog post

1

u/Hot-Profession4091 Feb 25 '24

I can’t believe how many of you are just vehemently opposed to precompiling a binary (maybe several, depending on what platforms you support) and publishing it to the releases page. It’s almost like you don’t want people to use the software that you… spent a lot of time creating for free with the explicit hope other people may find it useful.

2

u/ThadicalReform Apr 01 '24

It's legit wild. I complain to my developer friend all the time about being unable to use this or that software and he's always unsympathetic because "it's easy", and then I will spend two hours of my life trying to install something, fail, and ask him and he'll be like, "oh, yeah, it's because you have to install this dependency on this totally different website that I only know about because it was discussed in the comments thread of this blog I read".

And just, yeah, no, fuck your software if all I can get off Github if a pile of bits I have to try to put it together myself. Let me know when it's in the app store.

1

u/szank Feb 25 '24

It's a pain. And there are already software distribution platforms for open source code where people compile and package source code for others to use. So why reinvent the wheel ?

If anything devs would rather publish a docker image. Much less hassle. Entitlement is everywhere 🤷‍♂️

1

u/Hot-Profession4091 Feb 25 '24

Bub, it is not a pain to setup a GitHub action to pre-compile your software and attach it to the release. If it is, you’ve done something wrong. I’m obviously talking about executables here, not libraries.

1

u/ExplorerIll5684 Feb 25 '24

Not every website needs to fool-proof itself for the sake of end users. IMHO, if you can distribute a link to a webpage and that webpage has sufficient instructions for an end user, then that's all anyone should need. The README file that is typically included with each repo and embedded in that repo's webpage accomplishes that. GitHub goes beyond this by including a releases feature that developers additionally have the option of using. What I'm against is supporting the enforcement of a feature that would only serve to inconvenience the actual customers, simply in order to cater to people too lazy to read instructions and/or people who were never the intended users of the software to begin with.

Also, I've literally gotten the argument that having to look for a download link in the README is just too inconvenient and that it therefore constitutes "bad design" on GitHub's behalf. If these are the people that are complaining then I wouldn't be surprised if at least some developers would prefer it if they didn't use their software. After all, people who don't get paid for their software definitely aren't getting paid to deal with the complaints of people who won't even read the README.

2

u/Hot-Profession4091 Feb 25 '24

Have you seen the READMEs most devs write?

1

u/ExplorerIll5684 Feb 25 '24 edited Feb 25 '24

As a developer I've definitely seen some bad documentation, and I've personally had to look at the source code of libraries directly in way too many instances. The expectations for a dev are already high - you'll get the RTFM acronym thrown at you if you do look at the documentation but simply fail to find the obvious answer yourself because you didn't use a search engine. So forgive me if I fail to understand the woes of someone who refuses to read the documentation because it's just not to their liking.

0

u/ExplorerIll5684 Feb 26 '24 edited Feb 26 '24

On second thought, this is just ridiculous. Developers are end users too. Maybe I'm just a fast reader but I've never had to take more than literally seconds of my time to find a download link in a README. Many of the people complaining about it literally write longer complaints than many of the READMEs they're complaining about having to read. I have the receipts to prove it.

The top Google search result for "github download link reddit" is a post of someone asking how to download something that looked like this, at the time of posting. That was the top of the README file.

To all downvoters: To be clear, nobody is begging you to use their software. You can choose to use it or not. If you try to force such a ridiculous change on developers, don't be surprised when those developers start jumping ship for alternative solutions that don't restrict their ability to decide how their software is developed and distributed. Seems counterproductive to me but I don't care, I'm just giving my perspective as a person of the demographic that GitHub actually targets.

1

u/ST0PPELB4RT Feb 25 '24

The answer to your question aside. I am amazed on how many people seem to be entrenched in a developer world view. There are other professions in this world. And most people on this earth are just users not devs.

If your tool targets non-tech people, you should think about them. They are not entitled to anything but if you want it used make it as painless for your target demographic to use as you are comfortable with.

Personally I would say. Has a GUI and runs on windows? Well... An EXE isn't that far off. Package myself or link a py2exe thingy in the installation instruction? How normie do I want the user to be?

Projects that provide a nice-to-have piece of software don't have to be. I would just spell it out "Coded in a weekend. Didn't look into it since then. No warranties."

1

u/ExplorerIll5684 Mar 27 '24 edited Mar 27 '24

I think it's interesting that you would assume the developers don't think about the end user. I've personally never had an issue using GitHub as an end user, but I have always understood that GitHub is for developers first. Not all developers will spend the time making all of their software accessible to the average user, and there is nothing wrong with that. Sometimes it's easier said than done, and unless you're paying the developer for their work you have no business telling them how to develop or distribute their software.

At the end of the day it's up to the user to read the instructions (the README). If that isn't sufficient then obviously the user isn't the target demographic to begin with. So the way I see it this is a PEBKAC issue.

0

u/MooseBoys Feb 25 '24

No. There are so many problems that GitHub would need to solve in order to make it a viable distribution platform for anything besides toy apps. I’d rather them focus on improving the platform for its intended purpose.

0

u/ruilvo Feb 25 '24

I download software on the releases page of a repo all the, as it is very common, especially with software geared for the already tech literate. It's fine, and I'd do the same if and when I need to release something because I also write stuff for the already tech literally.

You people are that mad because a 13 yo couldn't run their Facebook hack and complained on the Internet?

0

u/[deleted] Feb 25 '24

If they are using it as their main distribution source they should include, binaries or exes or whatever and clear instructions or notes as the first section of the readme to state that you download the release from GitHub with a link to it.

0

u/szank Feb 25 '24

It's the main distribution source for the source code. Outside of making the code available, there is no "should" or "must" here. Open source is about making the source code avaliable to the end user. The rest is gravy. Nice to have if the maintainers are so inclined. No one should expect anything more than bunch of source files tho.

-3

u/Fluffy_Force_9887 Feb 24 '24

Objectively correct take

2

u/patmorgan235 Feb 25 '24

I disagree. GitHub is for developers first. It doesn't make sense to start de-emphasizing developer focused portions of the UI in favor of software end-users.

If you need a user focused page whip together a GitHub Pages site or a simple WordPress site and embedded your GitHub Releases feed.

0

u/Joe-Arizona Feb 25 '24

Seems like it would be quite resource heavy on Github if tons of end users were downloading .exe’s from it.

If someone wants to provide those then it seems like the responsibility for hosting/distributing it is on them.

0

u/AshesToVices Feb 25 '24

Okay but here's the thing, and jus-just hear me out here, okay...?

I don't want to though.

-14

u/Inaeipathy Feb 25 '24

However, some developers are using Github as a distribution solution, and sometimes the only "official" means to access their software.

Ok, so you are entitled to an exe or what?

4

u/[deleted] Feb 25 '24 edited Feb 25 '24

[removed] — view removed comment

2

u/szank Feb 25 '24

It can be done by anyone who cares enough. It seems like no one does care enough at the moment .