Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/olback/library-loader

[Unofficial] Samacsys Library Loader for all platforms!
https://github.com/olback/library-loader

ci circleci eagle ecad gtk gtk-3 gtk-rs gui hacktoberfest kicad library-loader linux mac macos rust samacsys ui windows

Last synced: 1 day ago
JSON representation

[Unofficial] Samacsys Library Loader for all platforms!

Awesome Lists containing this project

README

        

# Library Loader :books:

Status: [![Build Status](https://drone.olback.dev/api/badges/olback/library-loader/status.svg)](https://drone.olback.dev/olback/library-loader)

## Getting started

1. Create an account on [componentsearchengine.com](https://componentsearchengine.com/) if you don't have one already.
2. Download a prebuilt version of library-loader from the [releases page](https://github.com/olback/library-loader/releases) (only linux builds available, see [#67](https://github.com/olback/library-loader/issues/67)).

### Simple install / uninstall

On the [releases page](https://github.com/olback/library-loader/releases), download the latest `library-loader-linux-dist.tar.gz` and untar it. Each release is bundled with two scripts for installing and uninstalling library-loader :

```sh
# Installs both cli/gui binaries in `/usr/bin`
# Installs desktop entry and icon for `library-loader-gui`
sudo install.sh

# Uninstall `library-loader` completely
sudo uninstall.sh
```

### Building from source using Docker

This allows you to build without installing any dependencies on your machine.

```
docker run --volume=$(pwd):/home/circleci/project olback/rust-gtk-linux cargo build --release
```

### Building from source locally(macOS)

Required binaries: brew(from homebrew), rustc, cargo
You have to install rust via rustup and initialize it with rustup-init command.

```shell
./macos-compile.sh
```

### Setup on macOS

Edit the `LibraryLoader.example.toml` and fill in your login details for `componentsearchengine.com`. Rename the file to `LibraryLoader.toml` and place it in `~/Library/Application Support/LibraryLoader.toml`.

e.g.

```shell
cp LibraryLoader.example.toml ~/Library/Application\ Support/LibraryLoader.toml"
```

### Running on macOS

GUI:

```shell
cargo run --bin library-loader-gui
```

or CLI:

```shell
cargo run --bin library-loader-cli
```

## What/Why?

This is an implementation of [https://www.samacsys.com/library-loader/](https://www.samacsys.com/library-loader/) in Rust. Why? Well, since the library-loader SamacSys provides only works on Windows, I thought it would be neat to make something similar but available to everyone.

For upcomming features, please see the [TODO.md](TODO.md).

## License

[GNU Affero General Public License v3.0](LICENSE)