Skip to content

Ykaros/phrame

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Phrame: A Simple CLI Tool for Adding Frames to Photos


Getting Started

There are pre-compiled binary files at release page

Download and compile from sources:

go get github.com/Ykaros/phrame

Install just the binary with Go:

go install github.com/Ykaros/phrame

Manual Installation

To build locally, first

git clone https://github.com/Ykaros/phrame.git

and then

cd phrame && task build

finally

./phrame -h

To set the command as global, simply

task global

Running Tests

Use:

task test

If everything goes well, you should see: Image successfully saved to: out/test.png ✓.


CLI Manual

Tip

Only [input_path] (either an image or a folder) is required. Most of the time, it can just be phrame -i [input_path]

The fundamental function of this CLI is to add customizable frames to images. To add frame(s) to image(s), use the following command:

phrame -q -i [input_path] -o [output_path] -r [border_ratio] -c [frame_color]

Except the root command, there are two available subcommands: sign and cut.

Sign

This subcommand is used to add a signature (watermark) on the frame. I personally am not interested in anything that blinds any part of my photo so this tool is for you if you have same concerns. The complete command goes like:

phrame sign -s [signature] -i [input_path] -o [output_path] -r [border_ratio] -c [frame_color] -x [font_size] -y [font_color]

To make it more customizable, it supports loading any font (.ttf) by simply replacing the default font (Inter-Regular) named by "font.ttf" with whatever font you are fond of.

CUT

The cut subcommand can be used to divide an image into either four or nine equal parts:

phrame cut [image_path] -g [4 or 9]

License

This project is licensed under the MIT License - see the LICENSE file for details