CHANGEME_DESC
Explore the docs ยป
View Demo
ยท
Report Bug
ยท
Request Feature
CHANGEME_MANUAL
If you've got any questions please give the FAQ a check.
| Platform | Versions | | :------------------------------- | :-------------- | | Windows | 7 and above | | Linux | Anything really | | MacOS | 10.15 and above | | All Platforms | All the above |
The PKGs are:
a. if you have an AUR manager (like paru or yay, which you should)
Just like with any other AUR pkg choose your prefered type and you can run the following command for example.
shell
paru -Sy tsfh
Search for tsfh in your app launcher and launch it.
b. Manually cloning and building it from AUR
First install the basic build dependencies, if you don't already have them:
shell
sudo pacman -Sy gcc base-devel --needed
Then clone the build script
shell
git clone https://aur.archlinux.org/tsfh.git # or tsfh-bin & tsfh-git
Cd into the new cloned repository and run the following to build the package
shell
makepkg
In order to install the package run the following (where * is just an any other characters place holder)
shell
sudo pacman -U tsfh-*.pkg.tar.zst
You are using NixOS, don't worry I got you bro.
You should use the app image. This does not provide a desktop file, you'll have to run it from the command-line. It's here just as another means if needed. I will try to make a ppa eventually.
Open a terminal in the folder where your download is and run the following command:
shell
sudo dpkg -i tsfh-linux.deb
Run tsfh in the terminal and there it is, the app.
You shouldn't use this method, install the tsfh-bin AUR pkg instead. This is here just as another means if needed.
From you Arch Linux command-line run the following command:
shell
sudo pacman -U tsfh-linux.pkg.tar.zst
Search for tsfh in your app launcher and launch it.
Damn simillar to portable binary, only real difference is this has an icon.
Use your archive manager or run in the terminal the following command:
shell
tar -xzf tsfh-macos-app.tar.gz
Double clikc the app folder you just downloaded and there you go the program works.
Works just like any other dmg installer you've used.
Note this method doesn't come with a desktop entry. You'll have to run the tsfh command or just create a shortcut yourself, it's really easy.
You will need to have homebrew installed, if you don't have it installed run the following command:
shell
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
You'll need to add my tap repository, run the following command for that:
shell
brew tap Obscurely/tap
Install the pkg.
shell
brew install tsfh
Might wanna take a look at the Usage Tab if you don't understand something about it.
This method will work across any Linux distribution, Windows 10/11 and macOS (Big Sur+ tested).
Run the following command in your terminal of choice:
shell
cargo install tsfh
Make sure you have .cargo/bin in path, for linux and macOS you would need to add the following line in your terminal RC file (e.g $HOME/.zshrc)
shell
export PATH=$HOME/.cargo/bin:$PATH # This is for Linux & macOS, look below for Windows.
On windows it should work automatically (restart if just installed), if not you can follow this guide for how to add something to path. The cargo bin folder will be Users\{your-user}\.cargo\bin
You may want to create a symlink on Linux & macOS or create a shortcut if you are on Windows to the bin file for easy access.
In order to update run the install command again, and you can now follow usage for more information on how to use it.
This program only uses cross platform libraries. The following steps require that you have rust installed, check their official installation page or use any pkg manager you may want. (There is also a shell.nix file in the repository if you use nix).
Clone this repository on your PC, you can use "git clone", if you have git installed, like this:
shell
git clone https://github.com/Obscurely/tsfh.git
Otherwise in the right up side of the repository page you will see a download button, download the repository as zip and extract it in a folder
Open a new terminal/cmd window in the folder you extracted the repository in, if you can't right click on the folder and open it there do:
shell
cd the/path
and you will get there.
From there run this compile command in the terminal:
shell
cargo build --release
It will take a bit depending on your system because of executable speed optimizations, but be patient.
Done, navigate to target/release and grab only the "tsfh" file from there.
In the provided video it's presented everything you should know on how to use tsfh. I also think the UI is intuitive enough, but I obviously can't have an unbiased opinion or a first look experience, so here you go.
CHANGEME_MANUAL
CHANGEME_MANUAL
The roadmap (kanban board) is located up top in the projects tab or at this link.
Contributions are always welcome!
Please read CONTRIBUTING.md and CODEOFCONDUCT.md, but to generalise it the basic process is: edit a file you want, do a pull request, I will look at it and if the change makes sense and is a good one I will accept it and that's it. Also be kind and respectful.
CHANGEME_MANUAL
tsfh is following Semantic Versioning 2.0.
If you happen to find any issues please carefully read SECURITY.md and strictly follow everything stated.
Is under MIT so stick to the license conditions and have fun :)
Either post an issue in the Issues Tab or contact me at this email address if you have more to say: obscurely.message@protonmail.com
