buypeeb-cs/readme.md

97 lines
2.4 KiB
Markdown
Raw Permalink Normal View History

buypeeb
===
2021-06-15 02:08:51 +00:00
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)
2021-06-15 02:08:51 +00:00
```bash
git clone https://git.bune.city/lynnesbian/buypeeb-cs
cd buypeeb-cs
sudo pacman -S dotnet-sdk
dotnet run
```
2020-09-06 09:53:19 +00:00
2020-09-06 10:59:46 +00:00
## quick install (arch linux)
2021-06-15 02:08:51 +00:00
2020-09-06 09:53:19 +00:00
```bash
mkdir buypeeb
cd buypeeb
2020-09-06 11:10:12 +00:00
curl -O https://git.bune.city/lynnesbian/buypeeb-cs/raw/branch/master/PKGBUILD
2020-09-06 09:53:19 +00:00
makepkg -si # installs to /usr/bin/buypeeb
2020-09-06 10:04:17 +00:00
buypeeb
2020-09-06 10:59:46 +00:00
```
2021-06-15 02:08:51 +00:00
---
2020-09-01 07:16:42 +00:00
## installing prerequisites
2021-06-15 02:08:51 +00:00
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.
2020-09-01 07:16:42 +00:00
### debian
2021-06-15 02:08:51 +00:00
follow [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/linux-debian) to add the dotnet repo
and install dotnet-sdk.
2020-09-01 07:18:31 +00:00
2020-09-01 07:16:42 +00:00
### arch linux
2021-06-15 02:08:51 +00:00
2020-09-01 07:12:58 +00:00
```
sudo pacman -S dotnet-sdk
```
2020-08-31 13:58:27 +00:00
2021-06-15 02:08:51 +00:00
### other linux distros
follow [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/linux) to install the relevant dotnet
SDK.
2020-09-01 07:16:42 +00:00
### windows
2021-06-15 02:08:51 +00:00
- 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)
2020-09-01 07:18:31 +00:00
i have no idea how to install mono with gtksharp properly on windows, and believe me i tried
---
## compiling
2021-06-15 02:08:51 +00:00
```
dotnet build
```
---
2021-06-15 02:08:51 +00:00
2020-09-01 07:18:31 +00:00
## running
2021-06-15 02:08:51 +00:00
2020-08-31 13:56:32 +00:00
```
dotnet run
2020-08-31 13:56:32 +00:00
```
2020-09-01 07:18:31 +00:00
---
2021-06-15 02:08:51 +00:00
## compiling a standalone version
2021-06-15 02:08:51 +00:00
the standalone versions are rather big, so it's a good idea to compress them for distribution.
2021-06-15 02:08:51 +00:00
### linux
2021-06-15 02:08:51 +00:00
run `./release.sh`.
2021-06-15 02:08:51 +00:00
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
2021-06-15 02:08:51 +00:00
run `.\release.ps1`.
2021-06-15 02:08:51 +00:00
the binary will be located at `.\out\release\windows\buybeep.exe`, with a zip compressed version at `buypeep.zip` in the
same directory.
2020-09-01 07:18:31 +00:00
2021-06-15 02:08:51 +00:00
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.