A CLI application for interacting with ttm.sh
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Jake Walker 6a579633ba
Remove funny messages, add colours
3 years ago
.editorconfig Add 'from NPM' section and module docs 3 years ago
.gitignore Initial commit 3 years ago
LICENSE Initial commit 3 years ago
README.md Add asciinema demo 3 years ago
cli.js Remove funny messages, add colours 3 years ago
config.json Add estimated file life 3 years ago
index.js Remove funny messages, add colours 3 years ago
package.json Remove funny messages, add colours 3 years ago
yarn.lock Remove funny messages, add colours 3 years ago

README.md

ttm.sh CLI

A CLI application for interacting with ttm.sh.

asciicast

Although this is mainly a CLI application, there is also a module that you can use in your own projects!

1. Installation

1.1. From NPM

This method is recommended as there is less setup.

npm install -g ttmsh
# now you can use the command 'ttmsh'

1.2. From Source

git clone https://tildegit.org/jakew/ttmsh-cli.git
cd ttmsh-cli
npm install
npm link
# now you can use the command 'ttmsh' or 'node ./cli.js' or './cli.js' (only on nix)

2. Usage

2.1. Shorten

You can either include the URL in your command:

jakew@tilde:~$ ttmsh shorten https://google.co.uk
√ https://ttm.sh/Ef

...or not include it and be asked later:

jakew@tilde:~$ ttmsh shorten
√ Which URL would you like to shorten? · https://google.co.uk
√ https://ttm.sh/Ef

Note: You will be asked again if you pass in an invalid URL.

2.2. Upload

Like with shorten, you can either include a file path in your command:

jakew@tilde:~$ ttmsh upload message.txt
√ https://ttm.sh/j0.txt

...or don't include it and be asked later:

jakew@tilde:~$ ttmsh upload
√ Which file would you like to upload? · message.txt
√ https://ttm.sh/j0.txt

3. Module

You can also use the mini API wrapper in your application. Here's some example code on how to use it.

const ttmsh = require("ttmsh");

// upload a file to ttm.sh
ttmsh.do("upload", "/path/to/file/to/upload.txt").then((result) => {
  console.log(`Here's your link: ${result}`);
}).catch((err) => {
  console.error("Something went wrong.", err);
});

// shorten a link with ttm.sh
ttmsh.do("shorten", "https://example.com/this/is/a/long/url").then((result) => {
  console.log(`Here's your link: ${result}`);
}).catch((err) => {
  console.error("Something went wrong.", err);
});

4. Contributing

I'd love for people to add in new features and improve on my current work so feel free to open a pull request!