shylie/serra
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

readme update

Browse Source
This commit is contained in:
Florian Baumann 2022-02-02 10:49:53 +01:00
parent abe29e4f14
commit dc6b70790b
1 changed files with 41 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
readme.md
View File

@ -1,19 +1,30 @@
# serra # serra
Serra is my personal Magic: The Gathering collection tool. Serra is my personal *Magic: The Gathering* collection tracker.
It uses a MongoDB and [Scryfall](https://scryfall.com).
It began as a holiday project in winter 2021/2022 because I was frustrated of
Collection Tracker Websites that are:
* Pain to use
* Want ~$10 a month
* Don't have the features I want
So I started my own Collection Tracker using [Golang](https://golang.org),
[MongoDB](https://mongodb.com) and [Scryfall](https://scryfall.com) to have
an overview in what cards you own and what value they are.
## What Serra does ## What Serra does
* tracks prices * Tracks prices
* calculates statistics * Calculates statistics
* shows what cards/sets do best in value development. * Query/filter all of your cards
* Shows what cards/sets do best in value development.
## What Serra does not ## What Serra does not
* Does not give a shit about conditions (NM, M, GD...) * Does not give a shit about conditions (NM, M, GD...)
* Does not track if card is foil or not (may come in the future) * Does not track if card is foil or not (may come in the future)
* Its not configurable to have Dollar/US Prices * Is not configurable to have Dollar/US Prices
# Quickstart # Quickstart
@ -47,7 +58,7 @@ Usage:
## Add ## Add
To add a card to your collection To add a card to your collection.
![](https://github.com/noqqe/serra/blob/main/imgs/add.png) ![](https://github.com/noqqe/serra/blob/main/imgs/add.png)
@ -87,6 +98,29 @@ The update mechanism iterates over each card in your collection and fetches
its price. After all cards you own in a set are updated, the set value will its price. After all cards you own in a set are updated, the set value will
update. After all Sets are updated, the whole collection value is updated. update. After all Sets are updated, the whole collection value is updated.
## Adding all those cards, manually?
Yes. While there are serveral OCR/Photo Scanners for mtg cards, I found they
are not accurate enough. They guess Editions wrong, they have problems with
blue/black cards and so on.
I add my cards using a tiny shell wrapper, since they are sorted by editions
anyways.
```
./add-card-wrapper.fish usg
read> 17
👼🏻 Serra 0.0.1
Updating Card "Herald of Serra" amount to 2
read> 18
...
```
Its basically typing 2-3 digit numbers and hitting enter. I was way faster
with this approach then Smartphone scanners.
# Install # Install
go build . go build .