Chocolatey Community Coffee Break

Join the Chocolatey Team on our regular monthly stream where we discuss all things Community, what we do, how you can get involved and answer your Chocolatey questions.

Learn More

Chocolatey Product Spotlight

Join the Chocolatey Team on our regular monthly stream where we put a spotlight on the most recent Chocolatey product releases. You'll have a chance to have your questions answered in a live Ask Me Anything format.

Learn More

Announcing Chocolatey Central Management 0.10.0

Livestream from
Thursday, 06 October 2022

We recently released our largest update to Chocolatey Central Management so far. Join Gary and Steph to find out more about Chocolatey Central Management and the new features and fixes we've added to this release.

Watch On-Demand
Chocolatey and Intune Overview

Webinar Replay from
Wednesday, 30 March 2022

At Chocolatey Software we strive for simple, and teaching others. Let us teach you just how simple it could be to keep your 3rd party applications updated across your devices, all with Intune!

Watch On-Demand
Chocolatey For Business. In Azure. In One Click.

Livestream from
Thursday, 9 June 2022

Join James and Josh to show you how you can get the Chocolatey For Business recommended infrastructure and workflow, created, in Azure, in around 20 minutes.

Watch On-Demand
The Future of Chocolatey CLI

Livestream from
Thursday, 04 August 2022

Join Paul and Gary to hear more about the plans for the Chocolatey CLI in the not so distant future. We'll talk about some cool new features, long term asks from Customers and Community and how you can get involved!

Watch On-Demand
Hacktoberfest Tuesdays 2022

Livestreams from
October 2022

For Hacktoberfest, Chocolatey ran a livestream every Tuesday! Re-watch Cory, James, Gary, and Rain as they share knowledge on how to contribute to open-source projects such as Chocolatey CLI.

Watch On-Demand
Chocolatey Product Spotlight: Chocolatey 1.2.0 and Chocolatey Licensed Extension 5.0.0

Livestream from
Thursday, 03 November 2022

Join Paul and Gary for this months Chocolatey product livestream where we look at the latest release of Chocolatey 1.2.0, Chocolatey Licensed Extension 5.0.0 and shine a spotlight on the new hook scripts functionality. This opens up so many possibilities for Chocolatey CLI users!

Watch On-Demand
Chocolatey Coding Livestream

Livestream from
Tuesday, 29 November 2022

Join Josh as he adds the ability to manage Chocolatey GUI config and features with the Chocolatey Ansible Collection.

Watch On-Demand
Introduction into Chocolatey with Veeam

Webinar from
Tuesday, 13 December 2022

Join Gary, Paul, and Maurice as they introduce and demonstrate how to use Chocolatey! Questions will be answered live in an Ask Me Anything format.

Watch On-Demand

Downloads:

1,603

Downloads of v 0.6.2:

167

Last Update:

23 Dec 2022

Package Maintainer(s):

Software Author(s):

  • Matthew A. Miller

Tags:

koffee file folder explorer vim hjkl

Koffee

  • 1
  • 2
  • 3

0.6.2 | Updated: 23 Dec 2022

Downloads:

1,603

Downloads of v 0.6.2:

167

Maintainer(s):

Software Author(s):

  • Matthew A. Miller

Koffee 0.6.2

  • 1
  • 2
  • 3

Some Checks Have Failed or Are Not Yet Complete

Not All Tests Have Passed


Validation Testing Passed


Verification Testing Passed

Details

Scan Testing Resulted in Flagged as a Note:

At least one file within this package has greater than 0 detections, but less than 5

Details
Learn More

Deployment Method: Individual Install, Upgrade, & Uninstall

To install Koffee, run the following command from the command line or from PowerShell:

>

To upgrade Koffee, run the following command from the command line or from PowerShell:

>

To uninstall Koffee, run the following command from the command line or from PowerShell:

>

Deployment Method:

NOTE

This applies to both open source and commercial editions of Chocolatey.

1. Enter Your Internal Repository Url

(this should look similar to https://community.chocolatey.org/api/v2/)


2. Setup Your Environment

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

2. Get the package into your environment

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to https://community.chocolatey.org/api/v2/. Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Copy Your Script

choco upgrade koffee -y --source="'INTERNAL REPO URL'" [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:


choco upgrade koffee -y --source="'INTERNAL REPO URL'" 
$exitCode = $LASTEXITCODE

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0
}

Exit $exitCode

- name: Install koffee
  win_chocolatey:
    name: koffee
    version: '0.6.2'
    source: INTERNAL REPO URL
    state: present

See docs at https://docs.ansible.com/ansible/latest/modules/win_chocolatey_module.html.


chocolatey_package 'koffee' do
  action    :install
  source   'INTERNAL REPO URL'
  version  '0.6.2'
end

See docs at https://docs.chef.io/resource_chocolatey_package.html.


cChocoPackageInstaller koffee
{
    Name     = "koffee"
    Version  = "0.6.2"
    Source   = "INTERNAL REPO URL"
}

Requires cChoco DSC Resource. See docs at https://github.com/chocolatey/cChoco.


package { 'koffee':
  ensure   => '0.6.2',
  provider => 'chocolatey',
  source   => 'INTERNAL REPO URL',
}

Requires Puppet Chocolatey Provider module. See docs at https://forge.puppet.com/puppetlabs/chocolatey.


4. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

Package Approved

This package was approved as a trusted package on 24 Dec 2022.

Description

The Keyboard-Oriented File and Folder Explorer for Efficiency, or Koffee, is a no-nonsense alternative to Windows Explorer focused on VIM-style keyboard shortcuts, speed, and simplicity.


tools\VinylUI.dll
md5: BDC63C75BE91B927731C9D6C3BEC1DB5 | sha1: AD6E8B4234C233986C8E363DA8626B687F1CFDAF | sha256: D55ADC1AF1F6E02EF20E34627EA05A04EC24BDAA6EF70301665C1CAFC8FA5E1F | sha512: F99E4A264A0929C20A7F67315E4A8ECF8E14423E0991829A16B922B655E4D39949056A271284473832F2A8EF86DD6DACE0600E7B86CC2DEF2B12BDE6D7DA6513
tools\VERIFICATION.txt
VERIFICATION Verification is intended to assist the Chocolatey moderators and community in verifying that this package's
contents are trustworthy.

This package is published by the author, Matthew A. Miller. The binaries are identical to the ones in the zip file of
the same version published on the project's Releases on GitHub: https://github.com/mattstermiller/koffee/releases
tools\System.ValueTuple.dll
md5: 99CEC77DBEE0AB10B9FC4D52A1D414BE | sha1: C83D024E80C36B663458D478DFDB067336E2D616 | sha256: D6FB0DCFEE1490A8168117ED1B55758F11DB38475417B3668D19F89DCB55CBDD | sha512: 988B0FF9EDE87FE7538B2E0CDD684962965B4FC2A4F0FC92726248F249CACB7C5674F3978D2D7CBED68991C71E0B0339D6EDDA57384097A4DA8EFD7D77B43CD9
tools\System.Reactive.Windows.Threading.dll
md5: 0C3D968A8FA7B5E168BCA638B08D6340 | sha1: F68E615CB7E862F182188B848F4CB3D2FA3F6C5A | sha256: 606543755DED5775922F6529409297673660CBE4F778C87E971264DE8B07F11B | sha512: 1748ED8F66CE388AC595B10C70B7E4B7BF187ECC83EE29887A1656F74E9156D0334CDC422873ECE7CBF4B441393888110E17ECBDDFDA84444F3653AAD88CB7ED
tools\System.Reactive.PlatformServices.dll
md5: 14E9DBCA7A84AD21E47D89470AD4F941 | sha1: 5172083E9ECC81E3A7863E998585E6D6DA8ED7F3 | sha256: 69C49BED7B60DA26A620F4584DDEED63A7B98AB5FFF08E3FB44B5A42AC5FC7E7 | sha512: 74965AA925E5DFD015BAD9FEED4D686FC05F585C67B28564B23376D01540704AE705AF3D4B9EF4AF9332EEAA0D7839BF4BD19D9E9058EC16E5F0CAE29AE86DB2
tools\Koffee.exe
md5: F62AF2C45BD698AF5E80845F1E1E97DB | sha1: C631A165362C098337FA42DFD0C71360287B1EDF | sha256: 3D5B015F72F731577CD5E3023225C2533574C0635DB2D82A674A28EB927452EC | sha512: CAC2CE13F1745AFAF4FD878B983E0A0FD63032EE991159134911145A224FD8F8D9842488FB09241998C42AC25BD333107B6A8961D1EAE34E7CBADCBDDC0E5A03
tools\FSharp.Quotations.Evaluator.dll
md5: A2EB54622F06308EB8FC7C41A208144D | sha1: 7503C08158AB4CCCA2FFB50BDE827E778D6254EA | sha256: E48E97BA2D71269743F324977D01E5125562CAA5CB9C9E07F608F8F25678F978 | sha512: F25C95E6631AABFFA2099B984AC0196D29808FD6A75F0E717AE67B5606F2E59C33306887A175262A0FE4642E53DAFA2A38B72488024A8F304E8C1D9A021CFE2B
tools\FSharp.Core.dll
md5: BC2CEDB1997ABF9514669BE402AA3939 | sha1: 956C4E582CA7474FB1B9C6ADEC4CCC1E4C4A1ED1 | sha256: 8018E730E5A1E4C338EA174F5074C6541A3043445AF5BE867B8C1777BF83B901 | sha512: CF2AFF3D989B99B06F74875504ECB53C1680F497849F670DFC1D6CC23DD0D18FA375F0F74700070C0CF42AB7717CF595DFDA6B3C592BCA7C6338B832F53A0E43
tools\FSharp.Control.AsyncSeq.dll
md5: 459E5F61C0427127D92FA15547293A07 | sha1: A9050BBD8A287A93FC7AFA368F6EF8D2CA0E4ADF | sha256: AD751802914DDED21BD9A19234684645C34842620A52D031AAD7F184657F79C5 | sha512: F76091CC16B93C265453DF02229C1B21C9937CC58286A85D01E168FD32C31453490833A7FDC84BFD2E93B23BCF11032F128A8E6156D6D643BA9A334EEE1A5DC8
tools\DEVGUIDE.md
# Development Guide
The purpose of this document is to orient you in the Koffee codebase and to help you learn to effectively modify it.

## Setup
1. Install the build tools listed in the ["From Source" installation instructions in the Readme](README.md#from-source).
2. For the best experience, use Visual Studio Code with the Ionide extension or Visual Studio

## Architecture
Koffee is built on [VinylUI](https://github.com/Acadian-Ambulance/vinyl-ui), so you should familiarize yourself with
that library first. Reading the ReadMe should give you a decent idea of the overall structure of the UI framework.

The bulk of Koffee's code is for the Main window, which is split into MainModel, MainView and MainLogic.
- MainModel.fs contains all of the domain types for the Main window. This includes the model for the state of the window
    (`MainModel`) as well as the logical events (`MainEvents`).
- MainView.fs contains the bindings between the controls and the model (`binder`) and event mapping from control events
    to logical events (`events`). It also has functions for the status and error messages
- MainLogic.fs contains the controller, lower-level event handlers (key presses, input, etc), and the `dispatcher`
    function that maps events to event handlers. Most of the event handlers are organized into sub-modules:
    - `Main.Nav`: Opening folders and navigating paths
    - `Main.Search`: Find and Search handlers
    - `Main.Action`: Actions on file system items (create, move, copy, etc.)
    - `Main.Command`: Other commands such as opening items, settings, external tools, drag'n'drop and anything else that
        doesn't fit in the above categories

For instance, adding a new key-bindable command typically involves:
1. Adding an event type to MainEvents discriminated union and adding it to the Bindable list
2. Adding a keybinding in KeyBinding.fs
3. If a new piece of state is needed, add a property to MainModel
4. Adding an event handler function to the appropriate Main sub-module and adding a case to map the event to the new
    function in the dispatcher function

Still have questions? Open an issue or [email me](mailto:[email protected]) and we can discuss it!
tools\Acadian.FSharp.dll
md5: B37D8ACD9D431B94A8A861D0C272BA43 | sha1: 2A0F17133AAD0D4E1C48CAB10D2696D3862004F6 | sha256: 237F4AC1BEFDE42EABFCF66621E96AE1F300C766877C1E03FBFE6D555B7A3301 | sha512: 673A2F33D413CFD71883944BF760709DA080522B251DE9C3F7A5DF03B6BBE1D364881A20300522BC097CD55A9B1295F9CC7FD424858C01785BE4FEBF8C2FFAA0
tools\System.Reactive.Linq.dll
md5: 0D6D6C6D42F1F44DFB52CC6DD2271CBC | sha1: 752CEC0AE2CC65466E9497591ADB45578CF17939 | sha256: 19926C7D879A18C6C42C4D3D4689CA51EE2BE7A096E5A49473B0E1DACC099092 | sha512: EA5498C8F4B9A35342DE48AF81CC4F89A0E54C04CCA20C5749EEDF50842D222DAF18597F6782331B6ADBAFD8E9615D3165D923A42EF197AEA37351075842D6D3
tools\System.Reactive.Interfaces.dll
md5: B80E8C6C63A953FC1258D28996B0CA8F | sha1: 161C6845C2663B574D226FDF9BDE0F256D72DDD6 | sha256: ED6131702DF41A1C2C4AB1027614BC028C61D54C3261D7090D43838A79BD9266 | sha512: 253834FBD6C121674B2AF71CB591E210563D18E29B8511FD854B25EEC52D5137DE66D03BBFD0B79AE7F4A2FFB8398CE7F68D99090F01F9A863E53EDEEC4F4F96
tools\System.Reactive.Core.dll
md5: 20EAFE4DFB007D4321E8BAFC2F793A2E | sha1: 86458208B3E56629D9FE722C8F32354495C78D7A | sha256: FC483754462D2219E186A2C174E1CED3A5F30B648F04A3B0A7D1421E63569AF2 | sha512: 371C8FB7D467C86A4415926C7C3DC80AD6453E4F796ACC97351665A2628515F3AB8B6B537852BDE467E0111104A2DB17F667047531C1EB78BB99BCB19E365BA6
tools\RELEASE_NOTES.md
# Release Notes

### 0.6.2  (2022-12-23)
- #121 Adds command to Open Root Directory
- #128 Adds command to Open Default Path
- #120 Adds command to Repeat Previous Search
- #112 Adds commands to scroll view relative to cursor
- #116 Adds ability to delete search history
- #114 Adds "How To Use Koffee" link in settings window
- #111 Loads navigation history on startup
- #115 Allows commenting out Recursive Search Exclusions
- #124 Adds limit to length of BackStack and UndoStack
- #125 Moves hard-coded limits to Config
- #119 Adds input error messages when Find input is not found or Search regex is invalid
- #70 Changes undo move/copy to undo individual file operations for more correct behavior when folders were merged
- #123 Fixes path suggestions not being sorted by MRU
- #126 Fixes search results to sort by current sort setting instead of always name ascending
- #118 Fixes window size and position on opening to fit inside the current screen
- #122 Re-opening search input selects text for easy replacement
- Simplifies same-folder copy naming
- Reorders keybindings in Settings list to hopefully be more logical

### 0.6.1  (2021-09-01)
- #109 Fixes path arg parsing to recognize root and drives, fixes path shown when opening default path via args
- #110 Fixes error when toggling hidden files in empty search result
- #108 Disallows invalid chars in name prompts

### 0.6.0  Dark Theme and History Display (2021-06-02)
- Changes UI to use new dark theme
- #104 Adds Saved Searches
- #20 Adds display of navigation history for Back/Forward (Thanks @jilleJr)
- #17 Adds display of undo/redo history
- #24 Adds display of status history
- #63 Adds per-folder storage of sort settings (Thanks @jilleJr)
- #94 Adds support for environment variable substitution in path box (Thanks @jilleJr)
- #99 Adds repeat count for cursor movement, Parent Folder, Back, Forward, Undo, Redo, Find Next (Thanks @jilleJr)
- #90 Adds support for drag'n'drop into Koffee (single items only for now)
- #91 Adds support for drag'n'drop out of Koffee
- #81 Adds ability to remove a path from path history suggestions
- #103 Adds search history display
- #102 Adds recursive search folder exclusions
- Adds "Open File and Exit" command
- Changes Search history to also remember Sub-Folders setting
- Changes clearing search to reset search flags
- Changes Escape key in path box to always switch focus back to item grid and reset path box to current location
- Changes Tab key in path box to always move cursor to end
- Changes path history limit from 200 to 500
- Adds icons to Create File/Folder prompts
- #80 Fixes the Append to Name and Replace Name renaming commands to no longer use extension logic on folders
- #82 Fixes focus being lost after clicking grid item and opening folder
- #83 Fixes renaming an item to update its sort position
- #87 Fixes toggling hidden files not hiding selected item
- #88 Fixes refreshing search results
- #95 Fixes search to respect hidden file setting
- Fixes copy to clipboard not working on drives, net hosts and net shares
- Fixes file size decimal place always showing 0
- Fixes undo/redo actions that throw error not being removed, blocking all other undo/redo actions
- Fixes double ending slash in unix drive path formatting
- Fixes empty item message when deleting last search result
- Upgrades project to .NET Core SDK format. The `dotnet` command works in the repository folder to build, test, run, etc.

### 0.5.2  (2020-01-17)
- #76 Fixes error when deleting the last item in a folder

### 0.5.1  (2019-11-15)
- #75 Fixes crash on startup when the Koffee AppData folder does not exist

### 0.5.0  Recursive Search (2019-11-11)
- #54 Adds path suggestions as you type in the path box
- #51 Changes Find to a "Starts with" jump
- #73 Changes Search to filter as you type, moves case-sensitivity setting to search panel, makes Regex searching
  optional (default is now space-separated term matching)
- #23 Adds recursive sub-folder searching
- #22 Adds search history
- #74 Adds command to clear yank register
- Fixes deadlock/hang when rapidly moving or resizing the window multiple times
- Replaces configuration back-end, changing format to JSON and eliminating file load latency

### 0.4.2  (2019-06-20)
- Adds "Open With" command
- Adds "Open Properties" command
- Adds "Copy to Clipboard" command
- Adds "Start Create Shortcut to Item" command
- Adds ability to follow shortcuts to folders
- Adds ability to go back to previous path when opening to a default path
- Adds a trailing slash to path in path box
- Adds message and logging for non-crash errors
- Changes sorting to keep the same item selected
- Changes pressing Escape in path box to deselect when text is selected
- Refactored codebase to switch framework from FSharp.Desktop.UI to VinylUI
- Fixes moving folders across volumes
- Fixes opening new window to a drive root not opening correctly
- Fixes various issues when a path is provided in arguments
- Fixes path box to scroll horizontally instead of wrapping
- Fixes copy merge prompt message

### 0.4.1  Fixes and Refinements (2018-06-13)
- Adds item count and total size of files in status bar
- Adds status message when removing remembered network hosts
- Adds trailing slash on folders
- Adds Modified times to folders (Thanks Alex)
- Changes Modified times to show seconds
- Adds "B" to sizes to denote bytes (Thanks Alex)
- Adds sort indicator to column headers
- Adds pending key status message
- Adds crash logging and friendly error message
- Adds version number to title bar
- Cascades window position when opening multiple instances
- Double-clicking an item now opens it (Thanks Alex)
- Major refactors to improve error handling
- Fixes Ctrl + C crash
- Fixes wrong error message when attempting to recycle an item on a drive with no Recycle Bin
- Fixes extra config saves that could revert the yank register when switching between multiple windows
- Fixes display of underscores in status messages
- Fixes overwrite prompt not clearing previous input text
- Fixes path entry when entered path is same as current

### 0.4.0  Network and Multi-Window (2017-11-14)
- Adds support for network share and path navigation
- Adds New Window command
- Adds setting for commandline tool path
- Adds separate Find command for case-sensitivity
- Adds search setting and switches for case-sensitivity
- Adds confirmation prompt before overwriting bookmarks
- Adds setting to refresh window on focus
- Move/copy item buffer is now saved to config and shared across instances
- Fixes renaming to the same name with only casing differences
- Fixes create/rename/delete actions to do nothing on item types they can't apply to

### 0.3.1  (2017-09-24)
- Adds Settings button
- Fixed moving a folder reporting a false error message and not refreshing
- Fixed delete key not working in command input box
- Fixed opening Windows Explorer in an empty folder opening parent instead
- Fixed working directory for processes for opened files 
- Fixed undo move checking the wrong path for existing file
- Fixed create and rename overwriting existing files, now they give error message
- Fixed minimizing resets remembered window position and maximized state

### 0.3.0  Settings and Bookmarks (2017-08-07)
- Added ability to set, go to, and delete bookmarked locations
- Added sort by name, size, or modified ascending/descending
- Added Open With Text Editor command and setting for text editor path
- Added settings for startup path, path format, showing hidden files
- Added color for folders and hidden items
- Added search highlighting and match count
- Added date and size comparison for file overwrite prompt
- Replaced Rename command "replace extension" with "replace full name"
- Window size and position are now remembered
- Escape and Exit command now work when the path text box is focused
- Fixes crash when opening a file fails
- Fixes showing wrong name in move/copy overwrite prompt
- Fixes overwriting for move
- Fixes overwriting readonly and hidden files

### 0.2.1  (2017-03-18)
- Added Open Commandline
- Path box now replaces "~" with user's directory
- Window title now shows the current folder
- Move, copy and delete operations now show busy indication
- Fix crash when attempting to rename extension on items without an extension
- Fix unauthorized error when attempting to delete read-only items
- Fix empty item buffer appearing after executing a command
- Fix margins of path text box and command panel

### 0.2.0  File & Folder Manipulation (2017-01-28)
- Create, delete, rename, move, and copy files and folders
- Undo/redo of file and folder actions
- Back/forward navigation
- When navigating to parent folder, folder you were just in is selected
- Support for opening a path passed in as an argument to the executable
- Added icon and simple thematic elements

### 0.1.0  Initial Release (2016-10-22)
- Local file system navigation with VIM hotkeys
- Find by first character and search with regular expression in current folder
- Toggle between Windows and Unix-style path formats
tools\README.md
# Koffee
The Keyboard-Oriented File & Folder Explorer for Efficiency, or Koffee, is a no-nonsense alternative to Windows Explorer focused on VIM-style keyboard shortcuts, speed, and simplicity. It is built on .NET WPF, written in F#.

### Why would I want to use this?
**The goal of this application is to allow users to navigate and manipulate files and folders very quickly**, almost at the speed of thought -- a speed only achievable via keyboard. If you've ever experienced the productivity boost that comes from learning and using all the keyboard shortcuts in an application (or learned to use the text editor [VIM](http://www.vim.org/)), you understand what a big difference it makes.

![Screenshot](screenshot.png)

## Installation
Koffee depends on **Microsoft .NET Framework 4.5.1**. It is installed by default on Windows 8.1 or newer. Even on older versions of windows, you may already have it installed; look for it in the list of installed programs in "Programs and Features" (Windows 7 or Vista) or "Add or Remove Programs" (Windows XP). If you don't see it, head to [Microsoft's download page](https://www.microsoft.com/en-us/download/details.aspx?id=40773) to download and install it.

### From [Chocolatey](https://chocolatey.org/)

    choco install koffee

### From [Scoop](https://scoop.sh/)
Koffee is part of the "extras" bucket. If you haven't already, add this bucket with `scoop bucket add extras`.

    scoop install koffee

### From Installer or Zip
Go to the [releases page](https://github.com/mattstermiller/koffee/releases). From there, you can download and run **Koffee-Setup.exe**, which will guide you through the installation with a wizard. Or, if you prefer to install it yourself, you can download the zip file, unzip the app wherever you want and create your own shortcuts.

### From Source
You will need to have installed:
- [Visual Studio or VS Build Tools 2019](https://visualstudio.microsoft.com/downloads/)
  - Make sure to select the components ".NET Core SDK", ".NET Framework 4.5.1 targeting pack" and "F# compiler"

Steps:
- Clone this repository
- Open a terminal to the folder and run `.\fake.cmd build -t install`

## Using Koffee
First of all, take your hand off of the mouse because this is a keyboard tool! Once you're familiar with the hotkeys, you'll be navigating your files more quickly than you ever could with a mouse. If you're familiar with the text editor [VIM](http://www.vim.org/) which is popular among programmers, you should feel at home.

#### The Basics
_A capital letter indicates that the letter key is combined with Shift._
- `j` to move the cursor down
- `k` to move the cursor up
- `h` to go up to the parent folder
- `l` or `Enter` to open the selected file or folder
- `Shift + Enter` to open the "Open With" dialog for the selected file
- `H` to go back in navigation history
- `L` to go forward in navigation history
- `gr` to go to the root directory (Drives)
- `Tab` to switch between the main view and the path box
- `?` to open the Settings window, which displays the hotkeys for all commands.
- `Esc` to cancel actions, searches, path input, etc.
- `Ctrl + w` to exit

#### Advanced Navigation
- **Scroll quickly**
    - `Ctrl + j` and `Ctrl + k` move the cursor by half-pages at a time.
    - `gg` (press `g` twice) jumps to the first item, and `G` jumps to the last item.
- **Find / Jump to item**:
    - Press `f` then the beginning of a file or folder name. The cursor will jump to the first matching item as you type (not case-sensitive).
        - Press `;` during or after a Find to jump to the next matching item.
        - Press `Enter` to open the selected item and close Find.
        - Press `Esc` to close Find.
    - Press `F` to start a "multi" Find, which stays open when opening folders.
- **Search**:
    - Press `/` to start a search. This will move your cursor to a search input at the bottom of the window where you can enter space-separated search terms. The list will be filtered to matching items as you type.
    - Press `Ctrl + i` to toggle whether the search is case-sensitive.
    - Press `Ctrl + r` to toggle regular expression mode instead of term matching.
    - Press `Ctrl + s` to toggle sub-folder searching. A progress bar will show while results are loaded in the background.
    - Press `Up` to go back through previous searches and `Down` to go forward.
    - Press `Shift + Delete` when the previous searches are shown to delete the selected search history
    - Press `Enter` to close the search input and navigate the results. The current search filter will be shown at the bottom of the window.
    - Press `Esc` when the search input is open or when a search filter is active to cancel the search.
    - Press `n` to repeat the previous search when no search is active.
- **Bookmarks**
    - Set a bookmark by pressing `m`. The existing bookmarks are shown. Enter any character to set a bookmark to that character. Upper-case letters are distinct from lower-case letters.
    - Go to a bookmark by pressing `'`. The bookmarks are shown. Enter a character to activate the bookmark set to that character.
    - When viewing bookmarks, press `Delete` then a character to delete the bookmark set to that character.
- **Saved Searches**
    - To save an active search (the search input must be closed), press `m`. The existing saved searches are shown. Enter any character to set a saved search to that character. Upper-case letters are distinct from lower-case letters.
    - Activate a saved search by pressing `` ` ``. The saved searches are shown. Enter a character to activate the saved search set to that character.
    - When viewing saved searches, press `Delete` then a character to delete the saved search set to that character.
- **Sorting**
    - Press `sn` to sort by name, ascending then descending.
    - Press `sm` to sort by modified date, descending then ascending.
    - Press `ss` to sort by size, ascending then descending.
- **Path Box Suggestions** will appear when typing in the path box.
    - When no slashes are in the path box, folders that you have visited before are searched. Folders starting with the first search term are shown first, then other matches sorted by most recently visited.
    - When a path is in the path box, everything after the last slash is used to search the folder before the last slash. For example, typing "C:\Windows\sy 32" would suggest "C:\Windows\System32".
    - When suggestions are shown, use the up and down arrow keys to select a suggestion. When there is only one suggestion, it is selected automatically.
    - Press `Tab` to fill in the path box with the selected suggestion and continue typing, or press `Enter` to open the selected suggestion.
    - When suggestions from history are shown, pressing `Delete` will remove it from the list and history.

#### File & Folder Manipulation
- **Create File or Folder**: Press `o` to create a file or `O` to create a folder. Type in the name of the new item and press `Enter`.
- **Rename**: There are several ways to start renaming the currently selected file or folder.
    - Press `i` to start with the cursor at the beginning of the name
    - Press `a` to start with the cursor at the end of the name, before the extension
    - Press `A` to start with the cursor at the end of the extension
    - Press `c` to start with the name (without extension) selected so that typing will replace the name
    - Press `C` to start with the full name selected
    - When you are done editing the name, press `Enter`
- **Move / Copy / Shortcut**
    1. Press `d` to start a move, `y` to start a copy, or `Y` to start a shortcut of the selected file or folder. The item and operation will be displayed in the lower-right corner of the window.
    2. Navigate to the destination folder and press `p` to move, copy, or create a shortcut of the item there.
        - A copy to the same folder will append "(copy)" to the name.
        - If an item with the same name already exists, you will be prompted to overwrite it. If you choose to overwrite a folder, the contents will be merged (existing files in the destination with the same name will be overwritten, but the others will remain).
- **Delete**
    - Press `Delete` to send the currently selected item to the Recycle Bin. If the item cannot be recycled, an error message will be shown instead.
    - Press `Shift + Delete` to delete it permanently. You will be prompted to make sure this is what you want to do; press `y` to proceed with deletion or press `n` to cancel.
- **Undo / Redo Action**
    - Press `u` to undo the last file or folder action (this includes creating, renaming, moving, copying and deleting). The status bar will report the action that was undone. Since deletions cannot be undone, the status bar will simply report the deletion that cannot be undone.
    - Press `U` to redo the last action that was undone. Note that performing any action after an undo will clear the redo list.
    - Press `gu` to display undo / redo history.

- **Copy to Clipboard**: Press `Ctrl + c` to copy the selected item to the Windows Clipboard.
    - Paste in Windows Explorer or another app that accepts files to copy the file or folder there.
    - Paste in any text editor or text input to insert the file or folder's path there.

#### Other
- Repeat cursor, navigation and undo/redo commands by pressing numbers before the command. For example, pressing `4H` will go back 4 times.
- Display navigation history for Back/Forward with `gh`
- Display status message history with `gs`
- Open the selected file and exit with `Ctrl + Enter`
- Open the selected file or folder's properties with `Alt + Enter`
- Open a second window for easier file comparison or moves with `Ctrl + n`
- Open Windows Explorer at your current location with `Ctrl + Shift + e`
- Open the commandline tool (configured in the Settings window) at your current location with `Ctrl + Shift + c`
- Open the currently selected file with your text editor (configured in the Settings window) with `Ctrl + Shift + t`
- Show/hide hidden files and folders with `F9`

There are more commands at your disposal. Open the Settings window with `?` for the full list of commands and their key bindings!

## Contributing
If you want to contribute to Koffee, thank you! Head to the [issues page](https://github.com/mattstermiller/koffee/issues).
- Did you find a bug or issue in Koffee? Please create a new issue!
- Do you have an idea for a cool new feature? Please create an issue and detail your idea and how it would work!
- Do you want to contribute but not sure where to start? Look for issues that you might be interested in working on.
    The `help wanted` tag is used for issues that are easier for newcomers to pick up. Bonus if the issue is part of the
    next milestone, but that's not necessary!
- Still not sure? [Email me](mailto:[email protected]) and we can discuss it!

Please read the [Development Guide](DEVGUIDE.md) to get started on Koffee code.

## Future Planned Features
- Select multiple items
- Configurable hotkeys
- Theme selection and editor
- And more... check out the [issues list](https://github.com/mattstermiller/koffee/issues) and please add your own ideas and contributions!
tools\Newtonsoft.Json.dll
md5: 6815034209687816D8CF401877EC8133 | sha1: 1248142EB45EED3BEB0D9A2D3B8BED5FE2569B10 | sha256: 7F912B28A07C226E0BE3ACFB2F57F050538ABA0100FA1F0BF2C39F1A1F1DA814 | sha512: 3398094CE429AB5DCDECF2AD04803230669BB4ACCAEF7083992E9B87AFAC55841BA8DEF2A5168358BD17E60799E55D076B0E5CA44C86B9E6C91150D3DC37C721
tools\LICENSE.txt
MIT License

Copyright (c) 2016 Matthew Anthony Miller

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
tools\KoffeeUI.dll
md5: F032CBF80C7D0A48D02935F17E4DCF27 | sha1: F02DB69667CD3364A31892C52E771224BCA10500 | sha256: 75B1E74C6CFF8E01E1F0930E113D88A47B52F48F120F041D5D0652B0CA7FF254 | sha512: F78204CA31340C87FD26EF19CD15B25305ED369DD2022981821E3170BBF62D0B40BC45279DA4381774A5692797A3F77C0CE8B6453E7CBDDF3C9A541E646DE878
tools\Koffee.exe.gui
 
tools\Koffee.exe.config
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.1" />
  </startup>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <Paket>True</Paket>
        <assemblyIdentity name="Castle.Core" publicKeyToken="407dd0808d44fbdc" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="4.0.0.0" />
      </dependentAssembly>
    </assemblyBinding>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="FSharp.Core" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.7.0.0" newVersion="4.7.0.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Add to Builder Version Downloads Last Updated Status
Koffee 0.6.1 169 Wednesday, September 1, 2021 Approved
Koffee 0.6.0 118 Thursday, June 3, 2021 Approved
Koffee 0.5.2 432 Monday, January 20, 2020 Approved
Koffee 0.5.1 165 Saturday, November 16, 2019 Approved
Koffee 0.5.0 137 Monday, November 11, 2019 Approved
Koffee 0.4.2 219 Friday, June 21, 2019 Approved
Koffee 0.4.1 196 Sunday, April 21, 2019 Approved

This package has no dependencies.

Discussion for the Koffee Package

Ground Rules:

  • This discussion is only about Koffee and the Koffee package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Koffee, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus