semvec/pypi-packages huggingface dataset:
photomatrix 0.0.5
Concat photos together in a matrix
Requires Python: >=3.7

# Overview

Simple command-line application which concatenates a list of photos into a single photo
showing them in a matrix (in other words, a grid). 

# Installation

First of all, you need [Python](https://www.python.org/) 3.7 or greater installed in your system.

Then, as `photomatrix` is a command line application, open a terminal and be ready to type commands.

## Install automatically with pip

`photomatrix` is available from the Python Package Index ([PyPI](https://pypi.org/)), so installable
with [pip](https://pip.pypa.io/):

```
pip3 install photomatrix
```

You should now have `photomatrix` available in your shell. For example, print the command help:

```
photomatrix -h
```

## Build locally

Alternatively, you can build locally from source code. First, clone this project from Github.

Cd into the root folder.

Create a virtual environment (e.g. named `my_env`) and activate it:

```
python3 -m venv my_venv
source my_venv/bin/activate
```

Install the dev dependencies and the app dependencies into the virtual environment:

```
pip3 install -r requirements_dev.txt
pip3 install -e .
```

Run like this:

```
python3 -m photomatrix -h
```

# Usage

The basic usage is:

```
photomatrix INPUT_IMAGES OUTPUT_IMAGE
```

where all the images found in the specified input path will be loaded, sorted, combined in a matrix
and the result will be written in the specified output path.  

Further options that you can customize are:
* Number of rows vs columns
* Resize and crop
* Sorting
* Border
* Text to print (e.g. filename or Exif original date)

See the command help (with `-h`) for more info on these options.

# Examples

The following examples use these test input images:

<img src="data/input/01.jpg?raw=true" width="150">

up to

<img src="data/input/12.jpg?raw=true" width="150">

## Matrix with border

To build a matrix with a simple border:

```
photomatrix "data/input/*.jpg" data/output/matrix_border.jpg --border-width-ratio 0.1
```

resulting in:

<img src="data/output/matrix_border.jpg?raw=true" width="600">

## Matrix sorted and with text

To build a matrix with inverse filename order, printing the filename in top center position:

```
photomatrix "data/input/*.jpg" data/output/matrix_sort_text.jpg --sort filename_desc --text-type filename --text-position top_center
```

resulting in:

<img src="data/output/matrix_sort_text.jpg?raw=true" width="600">

# Integration Tests

Run the integration tests with:

```
python3 -m pytest tests/integration
```
tauntaun-live-editor 0.2.2
Project Tauntaun Live Editor
Requires Python: >=3.8

## Tauntaun Live Editor

![Screenshot](https://github.com/UOAF/project-tauntaun/raw/v0.1.0/images/screenshot.png)

![Unittests](https://github.com/UOAF/project-tauntaun/workflows/Unittests/badge.svg)

#### Description
Tauntaun Live Editor is browser based collaborative mission planning tool for DCS events.

#### Requirements
A [mapbox](https://www.mapbox.com/) access token (free tier is available)
#### Installation
#### Windows release
Executable is available under [releases](https://github.com/UOAF/project-tauntaun/releases).

##### Python 3.8
##### pip
```bash
pip install wheel # Only on Linux
pip install tauntaun_live_editor
```
##### archive
```bash
pip install wheel # Only on Linux

extract archive
cd extracted archive
pip install .
```

#### Upgrade
```
pip install --upgrade tauntaun_live_editor
```

#### Configuration
Configuration can be found at
```
Windows: C:/<User>/AppData/Roaming/tauntaun_live_editor/config.json
Linux: ~/.local/share/tauntaun_live_editor/config.json
MacOs: ~/Library/Application Support/tauntaun_live_editor/config.json
```
map_token: MapBox access token  
admin_password: password in SHA256 format, default is 1234
#### Run server
```
# Windows release
tauntaun_live_editor.exe

# Python module
tauntaun_live_editor
# Or if that does not work for some reason
py -m tauntaun_live_editor # Windows
python3 -m tauntaun_live_editor # Linux
```

#### Join to server
Open https://localhost:8080  
Enter admin mode with right clicking the arrow in the top left corner and enter the admin password. 

#### Wiki / How to use Tauntaun
https://github.com/UOAF/project-tauntaun/wiki

#### Bug reporting and feature requests
Use github issues:
https://github.com/UOAF/project-tauntaun/issues

#### License 
GNU General Public License v3 (GPLv3) (GPL)

#### Contact
https://github.com/UOAF/project-tauntaun  
https://discord.gg/ZkXCK3y