minor readme updates

This commit is contained in:
Lynne Megido 2021-06-15 12:08:51 +10:00
parent ecdc57fed6
commit 1af03bf2be
Signed by: lynnesbian
GPG key ID: F0A184B5213D9F90

View file

@ -1,9 +1,11 @@
buypeeb buypeeb
=== ===
a simple dotnet core program that allows you to track auctions on yahoo auctions japan, written in c#. designed for and with linux, but works on windows. a simple dotnet core program that allows you to track auctions on yahoo auctions japan, written in c#. designed for and
with linux, but works on windows.
## quick start (arch linux) ## quick start (arch linux)
```bash ```bash
git clone https://git.bune.city/lynnesbian/buypeeb-cs git clone https://git.bune.city/lynnesbian/buypeeb-cs
cd buypeeb-cs cd buypeeb-cs
@ -12,6 +14,7 @@ dotnet run
``` ```
## quick install (arch linux) ## quick install (arch linux)
```bash ```bash
mkdir buypeeb mkdir buypeeb
cd buypeeb cd buypeeb
@ -19,49 +22,75 @@ curl -O https://git.bune.city/lynnesbian/buypeeb-cs/raw/branch/master/PKGBUILD
makepkg -si # installs to /usr/bin/buypeeb makepkg -si # installs to /usr/bin/buypeeb
buypeeb buypeeb
``` ```
--- ---
## installing prerequisites ## installing prerequisites
you'll need the [dotnet core sdk](https://dotnet.microsoft.com/)
you'll need the [dotnet core sdk](https://dotnet.microsoft.com/). buypeeb is written for .NET 5.0, so you'll need to
make sure you install that SDK version.
### debian ### debian
follow [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/linux-debian) to add the dotnet repo and install dotnet-sdk.
follow [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/linux-debian) to add the dotnet repo
and install dotnet-sdk.
### arch linux ### arch linux
``` ```
sudo pacman -S dotnet-sdk sudo pacman -S dotnet-sdk
``` ```
### other linux distros
follow [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/linux) to install the relevant dotnet
SDK.
### windows ### windows
- download and install ".NET Core SDK" from [this page](https://dotnet.microsoft.com/download)
- run `dotnet build` - this *should* pull in gtk3 automatically - if not, you'll need to [install it yourself](https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases/latest) - download and install ".NET 5.0" from [this page](https://dotnet.microsoft.com/download/dotnet)
- run `dotnet build` - this *should* pull in gtk3 automatically - if not, you'll need
to [install it yourself](https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases/latest)
i have no idea how to install mono with gtksharp properly on windows, and believe me i tried i have no idea how to install mono with gtksharp properly on windows, and believe me i tried
--- ---
## compiling ## compiling
``` ```
dotnet build dotnet build
``` ```
--- ---
## running ## running
``` ```
dotnet run dotnet run
``` ```
--- ---
## compiling a standalone version ## compiling a standalone version
the standalone versions are rather big, so it's a good idea to compress them for distribution. the standalone versions are rather big, so it's a good idea to compress them for distribution.
### linux ### linux
run `./release.sh`. run `./release.sh`.
the binary will be located at `./out/release/linux/buypeeb`, with a [zstandard](https://facebook.github.io/zstd/) compressed version at `buypeeb.tar.zst` in the same directory. the binary will be located at `./out/release/linux/buypeeb`, with a [zstandard](https://facebook.github.io/zstd/)
compressed version at `buypeeb.tar.zst` in the same directory.
### windows ### windows
run `.\release.ps1`. run `.\release.ps1`.
the binary will be located at `.\out\release\windows\buybeep.exe`, with a zip compressed version at `buypeep.zip` in the same directory. the binary will be located at `.\out\release\windows\buybeep.exe`, with a zip compressed version at `buypeep.zip` in the
same directory.
unfortunately, however, this program won't work on machines that don't have GTK3 installed, and installing GTK3 is [quite an undertaking](https://www.gtk.org/docs/installations/windows/). a solution for this is [in the works](https://github.com/GtkSharp/GtkSharp/issues/119), but there's not really anything to be done about it right now. unfortunately, however, this program won't work on machines that don't have GTK3 installed, and installing GTK3
is [quite an undertaking](https://www.gtk.org/docs/installations/windows/). a solution for this
is [in the works](https://github.com/GtkSharp/GtkSharp/issues/119), but there's not really anything to be done about it
right now.