Skip to content

Commit 2f566c2

Browse files
authored
Update README - Usage
1 parent 391f48d commit 2f566c2

File tree

1 file changed

+20
-17
lines changed

1 file changed

+20
-17
lines changed

README.md

Lines changed: 20 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -41,10 +41,10 @@ _Note: On Windows 11, the context menu entries are located in the extended menu
4141

4242
### Related projects
4343

44-
This project started as a fork of [sorge13248/PasteIntoFile](https://github.com/sorge13248/PasteIntoFile), itself being a fork of [EslaMx7/PasteIntoFile](https://github.com/EslaMx7/PasteIntoFile).
45-
It is similar but more advanced than [PasteEx](https://github.com/huiyadanli/PasteEx), [Paste As File](https://pasteasfile.org), [PasteHere](https://github.com/tomzorz/PasteHere), [Paste To File](https://apps.microsoft.com/store/detail/paste-to-file/9PM34S06CFVJ) and [Advanced Paste](https://github.com/microsoft/PowerToys/releases/tag/v0.86.0).
44+
This project started as a fork of [sorge13248/PasteIntoFile](https://github.com/sorge13248/PasteIntoFile), itself being a fork of [EslaMx7/PasteIntoFile](https://github.com/EslaMx7/PasteIntoFile), both of which are no longer maintained.
45+
It is similar but more advanced than [PasteEx](https://github.com/huiyadanli/PasteEx) (FOSS), [Paste As File](https://pasteasfile.org) (trialware), [PasteHere](https://github.com/tomzorz/PasteHere) (unmaintained), [Paste To File](https://apps.microsoft.com/store/detail/paste-to-file/9PM34S06CFVJ) (no longer available) and [PowerToys Advanced Paste](https://learn.microsoft.com/en-us/windows/powertoys/advanced-paste).
4646

47-
This fork comes with many new features, a new fluid GUI and new console options.
47+
This fork comes with many new features: autosave, batch mode, more formats, keyboard shortcuts, a new fluid GUI and new console options.
4848
The full changelog can be found on the [release page](https://github.com/eltos/PasteIntoFile/releases).
4949
See the [contributors page](https://github.com/eltos/PasteIntoFile/graphs/contributors) for details on collaborators.
5050

@@ -79,14 +79,23 @@ This is the main mode of Paste Into File which allows saving clipboard contents
7979
To use this mode, run the program from the file explorer context menu, with the hotkey `WIN`+`ALT`+`V` (if enabled), from the tray (if enabled), from the start menu or via command line.
8080
If **clipboard patching** is enabled, the regular paste command and `CTRL`+`V` hotkey can also be used.
8181

82+
The file explorer context menu is accessed with a right click on a folder or the file explorer background (for windows 11 it is in the extended context menu ("more options" or SHIFT + right click).
83+
The context menu of existing files allows to replace or append into existing files, preserving filename and file type without showing the dialog.
84+
In the case of replace, the old file is moved to the recycle bin and can be restored with the usual undo options of the file explorer (e.g. `CTRL-Z`).
85+
86+
The **append into file** option allows to append data to existing files.
87+
This works only for supported file types (such as text or zip, not for images) and as long as the clipboard contains data compatible with the selected file type.
88+
If the file does not exist, it is created.
89+
This option is exspecially useful in combination with batch mode (see below).
90+
8291
If **autosave mode** is enabled, the file to paste will directly be created and selected for renaming.
8392
Otherwise, a dialog will prompt for filename and type.
8493
By holding `SHIFT` when the program starts, the autosave mode setting can be temporarily inverted (show the dialog even though autosave is enabled, or skip the dialog even though autosave is disabled).
8594
When running Paste Into File from the start menu or tray, the dialog will always be shown.
8695

87-
The **filename template** can be edited from the dialog or via command line (see [below](#template-format) for a description of the available formats).
96+
The **filename template** can be edited from the UI or via command line (see [below](#template-format) for a description of the available formats).
8897
When holding `CTRL` while the program starts, the file will be saved to a subdirectory.
89-
The corresponding template can be configured via command line (see below).
98+
The corresponding template can be configured from the UI or via command line (see below).
9099

91100
The available **file extensions** depend on the formats available in the clipboard.
92101
For example, if you copy a range of cells from a spreadsheet, the data is available not only as text, but also in DIF, RTF, SLK and HTML formats and even as screenshot.
@@ -95,7 +104,9 @@ An appropriate format is then chosen automatically[^save_plain_text] and a previ
95104
When selecting `*` as extension or in autosave mode, the file extensions is determined automatically, i.e. the clipboard is saved as image, if available, or else as text. The format is determined by the last used extension for the respective filetype (which can also be set via command line).
96105

97106
A special **batch mode** exists to monitor the clipboard and save it every time new contents are copied.
98-
If enabled, the filename is purely determined by the template (which supports a dedicated counter variable).
107+
If enabled, the filename is purely determined by the template and a new file is created for each copy (which supports a dedicated counter variable).
108+
In combination with "append into file", the data is collected in a single file instead (fixed filename).
109+
99110

100111
[^save_plain_text]: To force saving plain text data to a file with a special extension,
101112
prepend a dot to the file extension (the actual filename will still have only a single dot).
@@ -104,11 +115,6 @@ using `html` will cause the html-formatted text to be saved,
104115
while using `.html` will save the plain text.
105116

106117

107-
### Paste into existing files (Append/Replace)
108-
The context menu entry **Paste into this file (Append/Replace)** allows you to paste clipboard contents into existing files by either appending or replacing them.
109-
This works as long as the clipboard contains data compatible with the selected file type.
110-
In the case of replace, the old file is moved to the recycle bin and can be restored with the usual undo options of the file explorer (e.g. `CTRL-Z`).
111-
112118

113119
### Copy file contents
114120

@@ -147,20 +153,17 @@ Copyright © PasteIntoFile GitHub contributors
147153
PasteIntoFile 5.3.0.0
148154
Copyright © PasteIntoFile GitHub contributors
149155
150-
--append (Default: false) Append to file if it exists (and extension
151-
supports appending).
156+
--append (Default: false) Append to file if it exists (and extension supports appending).
152157
-a, --autosave Autosave file without prompt (true/false)
153158
-c, --clear Clear clipboard after save (true/false)
154159
-d, --directory Path of directory to save file into
155160
-f, --filename Filename template with optional format variables such as
156161
{0:yyyyMMdd HHmmSS} for current date and time
157162
{1:000} for batch-mode save counter
158-
May also contain a file extension and path fragment if used
159-
in paste mode.
163+
May also contain a file extension and path fragment if used in paste mode.
160164
--help Display this help screen.
161165
--overwrite (Default: false) Overwrite existing file without prompt.
162-
Requires --autosave=true. If append is also given, this
163-
only applies in case appending fails.
166+
Requires --autosave=true. If append is also given, this only applies in case appending fails.
164167
--version Display version information.
165168
```
166169

0 commit comments

Comments
 (0)