17 Commits
1.0 ... 1.0.7

Author SHA1 Message Date
882413fb1e 1.0.7 2025-07-12 05:51:33 -07:00
2cdeeef5b4 fix mac issues 2025-07-12 05:51:07 -07:00
afb8457489 fix spacing 2025-07-12 05:29:58 -07:00
2cb2208478 1.0.6 2025-07-10 15:39:03 -07:00
d21e48c1c9 fix launching 2025-07-10 15:38:22 -07:00
f916ba0059 fix version check 2025-07-07 11:32:38 -07:00
970d8c654f add version check 2025-07-07 11:02:07 -07:00
a5b3719d33 version preupdate 2025-07-07 10:29:23 -07:00
1200a1bfc2 updated to v2 api 2025-07-07 10:01:38 -07:00
af8a2dbd1e warning msg, readme 2025-07-04 10:24:23 -07:00
dd8282623e update README 2025-07-04 06:55:29 -07:00
a9367763f3 Merge pull request 'cleanup prompting' (#1) from cleanup into master
Reviewed-on: #1
2025-07-04 13:29:56 +00:00
7dd915b060 cleanup prompting 2025-07-04 06:10:25 -07:00
4e78277f99 Update README.md 2025-06-27 21:35:16 +00:00
ad97817e80 Update README.md 2025-06-27 21:05:46 +00:00
9a0606ce32 Update README.md 2025-06-27 21:04:45 +00:00
d4f841f8a0 update release script 2025-06-27 13:59:48 -07:00
7 changed files with 214 additions and 97 deletions

View File

@ -2,20 +2,21 @@
CLI tool for updating and launching [Project Epoch](https://www.project-epoch.net/) on Windows, Linux and macOS. CLI tool for updating and launching [Project Epoch](https://www.project-epoch.net/) on Windows, Linux and macOS.
## Setup ## Installing
### Windows
Download and extract the latest binary from the [releases](https://git.burkey.co/eburk/epochcli/releases) page or build from source yourself, then copy `epochcli.exe` to a location of your choice. To make it easy, just use the same folder as your Wow game files.
### Linux ### Linux
A `wine` prefix with `dxvk` installed is sufficient, or you can use something like Lutris or faugus-launcher and just use `epochcli` for updating. A `wine` prefix with `dxvk` installed is sufficient, or you can use something like Lutris or faugus-launcher and just use `epochcli` for updating.
Download and extract the latest binary from the [releases](https://git.burkey.co/eburk/epochcli/releases) page, build from source yourself, or use homebrew to install. Download and extract the latest binary from the [releases](https://git.burkey.co/eburk/epochcli/releases) page, build from source yourself, or use homebrew from the macOS instructions to install.
If you are an Arch Linux (or derivative) user, you can use the provided [AUR package](https://aur.archlinux.org/packages/epochcli) to install
A tutorial for the full setup of Epoch on Arch Linux [can be found here](https://burkey.co/posts/epoch-linux/)
### macOS ### macOS
For macOS, I've found the best way to run Wow is in a Parallels Win 11 VM. Kegworks, Codeweavers, etc crash when the game starts up and I have not found a good solution so far. Any suggestions would be welcome, see my contact information below. For macOS, I've found the best way to run Wow is in a Parallels Win 11 VM. Kegworks, Codeweavers, etc crash when the game starts up and I have not found a good solution so far. Any suggestions would be welcome, see my contact information below. I currently use a Parallels VM and run the Windows version of epochcli inside the VM as an updater and launcher.
You can easily install with homebrew or build from source yourself. I dont have time to setup codesigning right now so there are no binaries provided for macOS. For homebrew, do the following: You can easily install with homebrew or build from source yourself. I dont have time to setup codesigning right now so there are no binaries provided for macOS. For homebrew, do the following:
@ -27,10 +28,16 @@ brew install --HEAD epochcli
brew upgrade epochcli --fetch-HEAD brew upgrade epochcli --fetch-HEAD
``` ```
## First Run ### Windows
Download and extract the latest binary from the [releases](https://git.burkey.co/eburk/epochcli/releases) page or build from source yourself, then copy `epochcli.exe` to a location of your choice. To make it easy, just use the same folder as your Wow game files.
## Setup
![ss](ss.png)
1. Run `epochcli`. You will be taken through a setup process that configures the program and creates a config file at `$HOME/.config/epochcli/config.toml` 1. Run `epochcli`. You will be taken through a setup process that configures the program and creates a config file at `$HOME/.config/epochcli/config.toml`
2. You can now use `epochcli` as just a standalone updater or also a launcher based on your configuration. You can always run `epochcli -c` to redo the configuration or edit the config file manually 2. You can now use `epochcli` as a standalone updater, but it can also act as a launcher based on your configuration. You can always run `epochcli -c` to redo the configuration, or edit the config file manually
## Usage ## Usage
``` ```
@ -43,4 +50,4 @@ brew upgrade epochcli --fetch-HEAD
## Issues ## Issues
If you have any issues, [email me](mailto:evan@burkey.co) or ping `Battlehammer` on the Epoch discord If you have any issues, [email me](mailto:epochcli@burkey.co) or send a private message to `Battlehammer` on the Epoch discord

130
config.go
View File

@ -1,6 +1,7 @@
package main package main
import ( import (
"bufio"
"fmt" "fmt"
"github.com/BurntSushi/toml" "github.com/BurntSushi/toml"
"os" "os"
@ -13,6 +14,7 @@ import (
type Config struct { type Config struct {
WowDir string WowDir string
LaunchCmd string LaunchCmd string
WinePrefix string
EnableLauncher bool EnableLauncher bool
} }
@ -21,7 +23,10 @@ const (
configName = "config.toml" configName = "config.toml"
) )
var cfgPath string var (
configRun = false
cfgPath string
)
func setupConfig(rerun bool) (*Config, error) { func setupConfig(rerun bool) (*Config, error) {
home, err := os.UserHomeDir() home, err := os.UserHomeDir()
@ -38,60 +43,52 @@ func setupConfig(rerun bool) (*Config, error) {
_, statErr := os.Stat(cfgPath) _, statErr := os.Stat(cfgPath)
if rerun || os.IsNotExist(statErr) { if rerun || os.IsNotExist(statErr) {
fmt.Println("Enter the path to your Wow directory below:") configRun = true
var s string fmt.Println("Enter the path to your Wow directory below. Use the full path without shortcuts like '~' (ex: /home/user/epoch):")
_, err = fmt.Scanln(&s) s, err := readLine()
if err != nil { if err != nil {
return nil, fmt.Errorf("unable to read input: %v", err) return nil, fmt.Errorf("unable to read input: %v", err)
} }
newConfig.WowDir = strings.TrimSpace(s) newConfig.WowDir = s
for { fmt.Println()
fmt.Printf("Do you want to use epochcli to launch Wow? Select No if you plan on using a launcher tool like Lutris (y/n): ") p, err := promptYesNo(fmt.Sprintf("Do you want to use epochcli to launch Wow? Select No if you plan on using a launcher tool like Lutris (y/n): "))
_, err = fmt.Scanf("%s", &s) if err != nil {
if err != nil { return nil, err
return nil, fmt.Errorf("unable to read input: %v", err) }
} fmt.Println()
s = strings.TrimSpace(s)
if s == "y" || s == "Y" { if p {
newConfig.EnableLauncher = true newConfig.EnableLauncher = true
newConfig.LaunchCmd = path.Join(newConfig.WowDir, "Project-Epoch.exe")
if runtime.GOOS == "windows" { if runtime.GOOS == "windows" {
newConfig.LaunchCmd = path.Join(newConfig.WowDir, "Project-Epoch.exe") exePath, err := os.Executable()
exePath, err := os.Executable() if err != nil {
if err != nil { return nil, fmt.Errorf("unable to create desktop shortcut: %v", err)
fmt.Println("unable to create desktop shortcut: ", err)
break
}
err = makeLink(exePath, path.Join(home, "Desktop", "Project-Epoch.lnk"))
if err != nil {
fmt.Println("unable to create desktop shortcut: ", err)
}
break
} else {
fmt.Println("Enter your launch command to start Wow below. If you would rather configure this later in the configuration file, just press Enter")
fmt.Printf("> ")
_, err = fmt.Scanf("%s", &s)
if err != nil {
return nil, fmt.Errorf("unable to read input: %v", err)
}
s = strings.TrimSpace(s)
if s != "" {
newConfig.LaunchCmd = s
}
break
} }
} err = makeLink(exePath, path.Join(home, "Desktop", "Project-Epoch.lnk"))
if err != nil {
return nil, fmt.Errorf("unable to create desktop shortcut: %v", err)
}
} else {
s, err = input("Enter your wine prefix. Leave blank if you do not need to set WINEPREFIX")
if err != nil {
return nil, err
}
fmt.Println()
if s == "n" || s == "N" { newConfig.WinePrefix = s
break newConfig.LaunchCmd = "wine " + newConfig.LaunchCmd
}
fmt.Println("Please enter a valid value of either 'y' or 'n'") fmt.Println("Your launch command has been set to the following:")
if s == "" {
fmt.Printf("wine %s\n", newConfig.LaunchCmd)
} else {
fmt.Printf("WINEPREFIX=%s %s\n", newConfig.WinePrefix, newConfig.LaunchCmd)
}
fmt.Printf("Modify the configuration file at %s if you need to customize it\n\n", cfgPath)
}
} }
err = os.MkdirAll(filepath.Join(home, ".config", configDirName), 0755) err = os.MkdirAll(filepath.Join(home, ".config", configDirName), 0755)
@ -110,7 +107,7 @@ func setupConfig(rerun bool) (*Config, error) {
return nil, fmt.Errorf("unable to encode config file: %v", err) return nil, fmt.Errorf("unable to encode config file: %v", err)
} }
fmt.Println("Created new config at ", cfgPath) fmt.Printf("Created new config at %s\n\n", cfgPath)
} }
_, err = toml.DecodeFile(cfgPath, &newConfig) _, err = toml.DecodeFile(cfgPath, &newConfig)
@ -120,3 +117,42 @@ func setupConfig(rerun bool) (*Config, error) {
return &newConfig, nil return &newConfig, nil
} }
func promptYesNo(prompt string) (bool, error) {
for {
fmt.Print(prompt)
s, err := readLine()
if err != nil {
return false, fmt.Errorf("unable to read input: %v", err)
}
if s == "y" || s == "Y" {
return true, nil
}
if s == "n" || s == "N" {
return false, nil
}
fmt.Println("Please enter a valid value of either 'y' or 'n'")
}
}
func input(prompt string) (string, error) {
fmt.Println(prompt)
fmt.Printf("> ")
s, err := readLine()
if err != nil {
return "", fmt.Errorf("unable to read input: %v", err)
}
return s, nil
}
func readLine() (string, error) {
reader := bufio.NewReader(os.Stdin)
in, err := reader.ReadString('\n')
if err != nil {
return "", fmt.Errorf("unable to read input: %v", err)
}
return strings.TrimSpace(in), nil
}

79
main.go
View File

@ -11,17 +11,26 @@ import (
"os" "os"
"os/exec" "os/exec"
"path/filepath" "path/filepath"
"runtime"
"strings" "strings"
) )
const ( const (
manifestUrl = "https://updater.project-epoch.net/api/manifest" manifestUrl = "https://updater.project-epoch.net/api/v2/manifest"
defaultWowPath = "/path/to/wow" defaultWowPath = "/path/to/wow"
defaultLaunchCmd = "not configured" defaultLaunchCmd = "not configured"
) )
func main() { func main() {
outOfDate, err := needUpdate()
if err != nil {
log.Fatal(err)
}
if outOfDate {
fmt.Println("There is a new version of epochcli, you must update before running")
os.Exit(1)
}
var ( var (
helpFlag bool helpFlag bool
updateOnlyFlag bool updateOnlyFlag bool
@ -55,9 +64,14 @@ func main() {
log.Fatal(err) log.Fatal(err)
} }
fmt.Printf("%d files updated\n", stats.updated) fmt.Printf("%d files updated\n\n", stats.updated)
if stats.current > 0 { if stats.current > 0 {
fmt.Printf("%d files are already up to date\n", stats.current) fmt.Printf("%d files are already up to date\n\n", stats.current)
}
if configRun {
fmt.Println("Configuration complete!")
os.Exit(0)
} }
if updateOnlyFlag { if updateOnlyFlag {
@ -70,10 +84,19 @@ func main() {
} }
fmt.Println("Starting Epoch...") fmt.Println("Starting Epoch...")
if runtime.GOOS == "darwin" { var cmd = strings.Split(config.LaunchCmd, " ")
exec.Command("open", config.LaunchCmd).Run() ex := exec.Command(cmd[0], cmd[1:]...)
} else { cmdStr := strings.Join(cmd, " ")
exec.Command(config.LaunchCmd).Run() if config.WinePrefix != "" {
prefix := fmt.Sprintf("WINEPREFIX=%s", config.WinePrefix)
newEnv := append(os.Environ(), prefix)
ex.Env = newEnv
cmdStr = prefix + " " + cmdStr
}
fmt.Println("Running command:", cmdStr)
err = ex.Run()
if err != nil {
log.Fatal(err)
} }
} }
} }
@ -98,7 +121,10 @@ func downloadUpdate(config *Config, force bool) (DownloadStats, error) {
localPath := filepath.Join(config.WowDir, path) localPath := filepath.Join(config.WowDir, path)
localDir := filepath.Dir(localPath) localDir := filepath.Dir(localPath)
if _, err = os.Stat(localDir); os.IsNotExist(err) { if _, err = os.Stat(localDir); os.IsNotExist(err) {
os.MkdirAll(localDir, 0755) err = os.MkdirAll(localDir, 0755)
if err != nil {
return stats, fmt.Errorf("failed to create directory %s: %v", localDir, err)
}
} }
if !force { if !force {
@ -117,28 +143,35 @@ func downloadUpdate(config *Config, force bool) (DownloadStats, error) {
} }
} }
fmt.Printf(" %s...\n", localPath) fmt.Printf("Updating %s...\n", localPath)
outFile, err := os.Create(localPath) outFile, err := os.Create(localPath)
if err != nil { if err != nil {
return stats, err return stats, err
} }
defer outFile.Close()
resp, err := http.Get(file.URL) for _, url := range []string{file.Urls.Cloudflare, file.Urls.Digitalocean, file.Urls.None} {
if err != nil { resp, err := http.Get(url)
return stats, err if err != nil {
} outFile.Close()
defer resp.Body.Close() return stats, err
if resp.StatusCode != http.StatusOK { }
return stats, fmt.Errorf("failed to download update from %s, status code: %d", file.URL, resp.StatusCode) defer resp.Body.Close()
} if resp.StatusCode != http.StatusOK {
outFile.Close()
_, err = io.Copy(outFile, resp.Body) return stats, fmt.Errorf("failed to download update from %s, status code: %d", url, resp.StatusCode)
if err != nil { }
return stats, err
_, err = io.Copy(outFile, resp.Body)
if err != nil {
outFile.Close()
return stats, err
}
break
} }
outFile.Close()
stats.updated += 1 stats.updated += 1
} }

View File

@ -11,13 +11,18 @@ type File struct {
Hash string `json:"Hash"` Hash string `json:"Hash"`
Size int `json:"Size"` Size int `json:"Size"`
Custom bool `json:"Custom"` Custom bool `json:"Custom"`
URL string `json:"URL"` Urls struct {
Origin string `json:"Origin"` Digitalocean string `json:"digitalocean"`
Cloudflare string `json:"cloudflare"`
None string `json:"none"`
} `json:"Urls"`
} }
type Manifest struct { type Manifest struct {
Version string `json:"Version"` Version string `json:"Version"`
Files []File `json:"Files"` UID string `json:"Uid"`
Files []File `json:"Files"`
CheckedAt string `json:"checked_at"`
} }
func getManifest() (*Manifest, error) { func getManifest() (*Manifest, error) {

View File

@ -3,20 +3,20 @@
set -e set -e
rm -f ./*.tar.gz rm -f ./*.tar.gz
rm -rf bin rm -f ./*.zip
mkdir bin GOOS=linux GOARCH=amd64 go build -o epochcli
tar czvf epochcli-linux-amd64.tar.gz epochcli
rm ./epochcli
GOOS=linux GOARCH=amd64 go build -o bin/epochcli-linux-amd64 GOOS=linux GOARCH=arm64 go build -o epochcli
tar czvf epochcli-linux-amd64.tar.gz bin/epochcli-linux-amd64 tar czvf epochcli-linux-arm64.tar.gz epochcli
rm ./epochcli
GOOS=linux GOARCH=arm64 go build -o bin/epochcli-linux-arm64 GOOS=windows GOARCH=amd64 go build -o epochcli.exe
tar czvf epochcli-linux-arm64.tar.gz bin/epochcli-linux-arm64 zip -j epochcli-windows-amd64.zip epochcli.exe
rm ./epochcli.exe
GOOS=windows GOARCH=amd64 go build -o bin/epochcli-windows-amd64 GOOS=windows GOARCH=arm64 go build -o epochcli.exe
zip epochcli-windows-amd64.zip bin/epochcli-windows-amd64 zip -j epochcli-windows-arm64.zip epochcli.exe
rm ./epochcli.exe
GOOS=windows GOARCH=arm64 go build -o bin/epochcli-windows-arm64
zip epochcli-windows-arm64.zip bin/epochcli-windows-arm64
rm -rf bin

BIN
ss.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

36
version.go Normal file
View File

@ -0,0 +1,36 @@
package main
import (
"fmt"
"io"
"net/http"
"regexp"
)
const version = "1.0.7"
const versionUrl = "https://git.burkey.co/eburk/epochcli/raw/branch/master/version.go"
func needUpdate() (bool, error) {
resp, err := http.Get(versionUrl)
if err != nil {
return false, fmt.Errorf("unable to get version file: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
return false, fmt.Errorf("failed to download update, status code: %d", resp.StatusCode)
}
b, err := io.ReadAll(resp.Body)
if err != nil {
return false, fmt.Errorf("unable to read response body: %v", err)
}
re := regexp.MustCompile(`const version = "([\d.]+)"`)
ver := re.FindStringSubmatch(string(b))
if len(ver) < 2 || ver[1] == "" {
return false, fmt.Errorf("unable to find version in response")
}
return ver[1] != version, nil
}