Compare commits

..
2 Commits
Author SHA1 Message Date
liph 9becc60ef8 herdr 2026-08-29 22:56:04 +02:00
liph 4327b8ce0e deleted clipcascade, updated yazi 2026-08-29 22:55:55 +02:00
54 changed files with 1725 additions and 6767 deletions

No files matched your search

-674
View File
@@ -1,674 +0,0 @@
GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The GNU General Public License is a free, copyleft license for
software and other kinds of works.
The licenses for most software and other practical works are designed
to take away your freedom to share and change the works. By contrast,
the GNU General Public License is intended to guarantee your freedom to
share and change all versions of a program--to make sure it remains free
software for all its users. We, the Free Software Foundation, use the
GNU General Public License for most of our software; it applies also to
any other work released this way by its authors. You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
them if you wish), that you receive source code or can get it if you
want it, that you can change the software or use pieces of it in new
free programs, and that you know you can do these things.
To protect your rights, we need to prevent others from denying you
these rights or asking you to surrender the rights. Therefore, you have
certain responsibilities if you distribute copies of the software, or if
you modify it: responsibilities to respect the freedom of others.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must pass on to the recipients the same
freedoms that you received. You must make sure that they, too, receive
or can get the source code. And you must show them these terms so they
know their rights.
Developers that use the GNU GPL protect your rights with two steps:
(1) assert copyright on the software, and (2) offer you this License
giving you legal permission to copy, distribute and/or modify it.
For the developers' and authors' protection, the GPL clearly explains
that there is no warranty for this free software. For both users' and
authors' sake, the GPL requires that modified versions be marked as
changed, so that their problems will not be attributed erroneously to
authors of previous versions.
Some devices are designed to deny users access to install or run
modified versions of the software inside them, although the manufacturer
can do so. This is fundamentally incompatible with the aim of
protecting users' freedom to change the software. The systematic
pattern of such abuse occurs in the area of products for individuals to
use, which is precisely where it is most unacceptable. Therefore, we
have designed this version of the GPL to prohibit the practice for those
products. If such problems arise substantially in other domains, we
stand ready to extend this provision to those domains in future versions
of the GPL, as needed to protect the freedom of users.
Finally, every program is threatened constantly by software patents.
States should not allow patents to restrict development and use of
software on general-purpose computers, but in those that do, we wish to
avoid the special danger that patents applied to a free program could
make it effectively proprietary. To prevent this, the GPL assures that
patents cannot be used to render the program non-free.
The precise terms and conditions for copying, distribution and
modification follow.
TERMS AND CONDITIONS
0. Definitions.
"This License" refers to version 3 of the GNU General Public License.
"Copyright" also means copyright-like laws that apply to other kinds of
works, such as semiconductor masks.
"The Program" refers to any copyrightable work licensed under this
License. Each licensee is addressed as "you". "Licensees" and
"recipients" may be individuals or organizations.
To "modify" a work means to copy from or adapt all or part of the work
in a fashion requiring copyright permission, other than the making of an
exact copy. The resulting work is called a "modified version" of the
earlier work or a work "based on" the earlier work.
A "covered work" means either the unmodified Program or a work based
on the Program.
To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for
infringement under applicable copyright law, except executing it on a
computer or modifying a private copy. Propagation includes copying,
distribution (with or without modification), making available to the
public, and in some countries other activities as well.
To "convey" a work means any kind of propagation that enables other
parties to make or receive copies. Mere interaction with a user through
a computer network, with no transfer of a copy, is not conveying.
An interactive user interface displays "Appropriate Legal Notices"
to the extent that it includes a convenient and prominently visible
feature that (1) displays an appropriate copyright notice, and (2)
tells the user that there is no warranty for the work (except to the
extent that warranties are provided), that licensees may convey the
work under this License, and how to view a copy of this License. If
the interface presents a list of user commands or options, such as a
menu, a prominent item in the list meets this criterion.
1. Source Code.
The "source code" for a work means the preferred form of the work
for making modifications to it. "Object code" means any non-source
form of a work.
A "Standard Interface" means an interface that either is an official
standard defined by a recognized standards body, or, in the case of
interfaces specified for a particular programming language, one that
is widely used among developers working in that language.
The "System Libraries" of an executable work include anything, other
than the work as a whole, that (a) is included in the normal form of
packaging a Major Component, but which is not part of that Major
Component, and (b) serves only to enable use of the work with that
Major Component, or to implement a Standard Interface for which an
implementation is available to the public in source code form. A
"Major Component", in this context, means a major essential component
(kernel, window system, and so on) of the specific operating system
(if any) on which the executable work runs, or a compiler used to
produce the work, or an object code interpreter used to run it.
The "Corresponding Source" for a work in object code form means all
the source code needed to generate, install, and (for an executable
work) run the object code and to modify the work, including scripts to
control those activities. However, it does not include the work's
System Libraries, or general-purpose tools or generally available free
programs which are used unmodified in performing those activities but
which are not part of the work. For example, Corresponding Source
includes interface definition files associated with source files for
the work, and the source code for shared libraries and dynamically
linked subprograms that the work is specifically designed to require,
such as by intimate data communication or control flow between those
subprograms and other parts of the work.
The Corresponding Source need not include anything that users
can regenerate automatically from other parts of the Corresponding
Source.
The Corresponding Source for a work in source code form is that
same work.
2. Basic Permissions.
All rights granted under this License are granted for the term of
copyright on the Program, and are irrevocable provided the stated
conditions are met. This License explicitly affirms your unlimited
permission to run the unmodified Program. The output from running a
covered work is covered by this License only if the output, given its
content, constitutes a covered work. This License acknowledges your
rights of fair use or other equivalent, as provided by copyright law.
You may make, run and propagate covered works that you do not
convey, without conditions so long as your license otherwise remains
in force. You may convey covered works to others for the sole purpose
of having them make modifications exclusively for you, or provide you
with facilities for running those works, provided that you comply with
the terms of this License in conveying all material for which you do
not control copyright. Those thus making or running the covered works
for you must do so exclusively on your behalf, under your direction
and control, on terms that prohibit them from making any copies of
your copyrighted material outside their relationship with you.
Conveying under any other circumstances is permitted solely under
the conditions stated below. Sublicensing is not allowed; section 10
makes it unnecessary.
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
No covered work shall be deemed part of an effective technological
measure under any applicable law fulfilling obligations under article
11 of the WIPO copyright treaty adopted on 20 December 1996, or
similar laws prohibiting or restricting circumvention of such
measures.
When you convey a covered work, you waive any legal power to forbid
circumvention of technological measures to the extent such circumvention
is effected by exercising rights under this License with respect to
the covered work, and you disclaim any intention to limit operation or
modification of the work as a means of enforcing, against the work's
users, your or third parties' legal rights to forbid circumvention of
technological measures.
4. Conveying Verbatim Copies.
You may convey verbatim copies of the Program's source code as you
receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice;
keep intact all notices stating that this License and any
non-permissive terms added in accord with section 7 apply to the code;
keep intact all notices of the absence of any warranty; and give all
recipients a copy of this License along with the Program.
You may charge any price or no price for each copy that you convey,
and you may offer support or warranty protection for a fee.
5. Conveying Modified Source Versions.
You may convey a work based on the Program, or the modifications to
produce it from the Program, in the form of source code under the
terms of section 4, provided that you also meet all of these conditions:
a) The work must carry prominent notices stating that you modified
it, and giving a relevant date.
b) The work must carry prominent notices stating that it is
released under this License and any conditions added under section
7. This requirement modifies the requirement in section 4 to
"keep intact all notices".
c) You must license the entire work, as a whole, under this
License to anyone who comes into possession of a copy. This
License will therefore apply, along with any applicable section 7
additional terms, to the whole of the work, and all its parts,
regardless of how they are packaged. This License gives no
permission to license the work in any other way, but it does not
invalidate such permission if you have separately received it.
d) If the work has interactive user interfaces, each must display
Appropriate Legal Notices; however, if the Program has interactive
interfaces that do not display Appropriate Legal Notices, your
work need not make them do so.
A compilation of a covered work with other separate and independent
works, which are not by their nature extensions of the covered work,
and which are not combined with it such as to form a larger program,
in or on a volume of a storage or distribution medium, is called an
"aggregate" if the compilation and its resulting copyright are not
used to limit the access or legal rights of the compilation's users
beyond what the individual works permit. Inclusion of a covered work
in an aggregate does not cause this License to apply to the other
parts of the aggregate.
6. Conveying Non-Source Forms.
You may convey a covered work in object code form under the terms
of sections 4 and 5, provided that you also convey the
machine-readable Corresponding Source under the terms of this License,
in one of these ways:
a) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by the
Corresponding Source fixed on a durable physical medium
customarily used for software interchange.
b) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by a
written offer, valid for at least three years and valid for as
long as you offer spare parts or customer support for that product
model, to give anyone who possesses the object code either (1) a
copy of the Corresponding Source for all the software in the
product that is covered by this License, on a durable physical
medium customarily used for software interchange, for a price no
more than your reasonable cost of physically performing this
conveying of source, or (2) access to copy the
Corresponding Source from a network server at no charge.
c) Convey individual copies of the object code with a copy of the
written offer to provide the Corresponding Source. This
alternative is allowed only occasionally and noncommercially, and
only if you received the object code with such an offer, in accord
with subsection 6b.
d) Convey the object code by offering access from a designated
place (gratis or for a charge), and offer equivalent access to the
Corresponding Source in the same way through the same place at no
further charge. You need not require recipients to copy the
Corresponding Source along with the object code. If the place to
copy the object code is a network server, the Corresponding Source
may be on a different server (operated by you or a third party)
that supports equivalent copying facilities, provided you maintain
clear directions next to the object code saying where to find the
Corresponding Source. Regardless of what server hosts the
Corresponding Source, you remain obligated to ensure that it is
available for as long as needed to satisfy these requirements.
e) Convey the object code using peer-to-peer transmission, provided
you inform other peers where the object code and Corresponding
Source of the work are being offered to the general public at no
charge under subsection 6d.
A separable portion of the object code, whose source code is excluded
from the Corresponding Source as a System Library, need not be
included in conveying the object code work.
A "User Product" is either (1) a "consumer product", which means any
tangible personal property which is normally used for personal, family,
or household purposes, or (2) anything designed or sold for incorporation
into a dwelling. In determining whether a product is a consumer product,
doubtful cases shall be resolved in favor of coverage. For a particular
product received by a particular user, "normally used" refers to a
typical or common use of that class of product, regardless of the status
of the particular user or of the way in which the particular user
actually uses, or expects or is expected to use, the product. A product
is a consumer product regardless of whether the product has substantial
commercial, industrial or non-consumer uses, unless such uses represent
the only significant mode of use of the product.
"Installation Information" for a User Product means any methods,
procedures, authorization keys, or other information required to install
and execute modified versions of a covered work in that User Product from
a modified version of its Corresponding Source. The information must
suffice to ensure that the continued functioning of the modified object
code is in no case prevented or interfered with solely because
modification has been made.
If you convey an object code work under this section in, or with, or
specifically for use in, a User Product, and the conveying occurs as
part of a transaction in which the right of possession and use of the
User Product is transferred to the recipient in perpetuity or for a
fixed term (regardless of how the transaction is characterized), the
Corresponding Source conveyed under this section must be accompanied
by the Installation Information. But this requirement does not apply
if neither you nor any third party retains the ability to install
modified object code on the User Product (for example, the work has
been installed in ROM).
The requirement to provide Installation Information does not include a
requirement to continue to provide support service, warranty, or updates
for a work that has been modified or installed by the recipient, or for
the User Product in which it has been modified or installed. Access to a
network may be denied when the modification itself materially and
adversely affects the operation of the network or violates the rules and
protocols for communication across the network.
Corresponding Source conveyed, and Installation Information provided,
in accord with this section must be in a format that is publicly
documented (and with an implementation available to the public in
source code form), and must require no special password or key for
unpacking, reading or copying.
7. Additional Terms.
"Additional permissions" are terms that supplement the terms of this
License by making exceptions from one or more of its conditions.
Additional permissions that are applicable to the entire Program shall
be treated as though they were included in this License, to the extent
that they are valid under applicable law. If additional permissions
apply only to part of the Program, that part may be used separately
under those permissions, but the entire Program remains governed by
this License without regard to the additional permissions.
When you convey a copy of a covered work, you may at your option
remove any additional permissions from that copy, or from any part of
it. (Additional permissions may be written to require their own
removal in certain cases when you modify the work.) You may place
additional permissions on material, added by you to a covered work,
for which you have or can give appropriate copyright permission.
Notwithstanding any other provision of this License, for material you
add to a covered work, you may (if authorized by the copyright holders of
that material) supplement the terms of this License with terms:
a) Disclaiming warranty or limiting liability differently from the
terms of sections 15 and 16 of this License; or
b) Requiring preservation of specified reasonable legal notices or
author attributions in that material or in the Appropriate Legal
Notices displayed by works containing it; or
c) Prohibiting misrepresentation of the origin of that material, or
requiring that modified versions of such material be marked in
reasonable ways as different from the original version; or
d) Limiting the use for publicity purposes of names of licensors or
authors of the material; or
e) Declining to grant rights under trademark law for use of some
trade names, trademarks, or service marks; or
f) Requiring indemnification of licensors and authors of that
material by anyone who conveys the material (or modified versions of
it) with contractual assumptions of liability to the recipient, for
any liability that these contractual assumptions directly impose on
those licensors and authors.
All other non-permissive additional terms are considered "further
restrictions" within the meaning of section 10. If the Program as you
received it, or any part of it, contains a notice stating that it is
governed by this License along with a term that is a further
restriction, you may remove that term. If a license document contains
a further restriction but permits relicensing or conveying under this
License, you may add to a covered work material governed by the terms
of that license document, provided that the further restriction does
not survive such relicensing or conveying.
If you add terms to a covered work in accord with this section, you
must place, in the relevant source files, a statement of the
additional terms that apply to those files, or a notice indicating
where to find the applicable terms.
Additional terms, permissive or non-permissive, may be stated in the
form of a separately written license, or stated as exceptions;
the above requirements apply either way.
8. Termination.
You may not propagate or modify a covered work except as expressly
provided under this License. Any attempt otherwise to propagate or
modify it is void, and will automatically terminate your rights under
this License (including any patent licenses granted under the third
paragraph of section 11).
However, if you cease all violation of this License, then your
license from a particular copyright holder is reinstated (a)
provisionally, unless and until the copyright holder explicitly and
finally terminates your license, and (b) permanently, if the copyright
holder fails to notify you of the violation by some reasonable means
prior to 60 days after the cessation.
Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from that
copyright holder, and you cure the violation prior to 30 days after
your receipt of the notice.
Termination of your rights under this section does not terminate the
licenses of parties who have received copies or rights from you under
this License. If your rights have been terminated and not permanently
reinstated, you do not qualify to receive new licenses for the same
material under section 10.
9. Acceptance Not Required for Having Copies.
You are not required to accept this License in order to receive or
run a copy of the Program. Ancillary propagation of a covered work
occurring solely as a consequence of using peer-to-peer transmission
to receive a copy likewise does not require acceptance. However,
nothing other than this License grants you permission to propagate or
modify any covered work. These actions infringe copyright if you do
not accept this License. Therefore, by modifying or propagating a
covered work, you indicate your acceptance of this License to do so.
10. Automatic Licensing of Downstream Recipients.
Each time you convey a covered work, the recipient automatically
receives a license from the original licensors, to run, modify and
propagate that work, subject to this License. You are not responsible
for enforcing compliance by third parties with this License.
An "entity transaction" is a transaction transferring control of an
organization, or substantially all assets of one, or subdividing an
organization, or merging organizations. If propagation of a covered
work results from an entity transaction, each party to that
transaction who receives a copy of the work also receives whatever
licenses to the work the party's predecessor in interest had or could
give under the previous paragraph, plus a right to possession of the
Corresponding Source of the work from the predecessor in interest, if
the predecessor has it or can get it with reasonable efforts.
You may not impose any further restrictions on the exercise of the
rights granted or affirmed under this License. For example, you may
not impose a license fee, royalty, or other charge for exercise of
rights granted under this License, and you may not initiate litigation
(including a cross-claim or counterclaim in a lawsuit) alleging that
any patent claim is infringed by making, using, selling, offering for
sale, or importing the Program or any portion of it.
11. Patents.
A "contributor" is a copyright holder who authorizes use under this
License of the Program or a work on which the Program is based. The
work thus licensed is called the contributor's "contributor version".
A contributor's "essential patent claims" are all patent claims
owned or controlled by the contributor, whether already acquired or
hereafter acquired, that would be infringed by some manner, permitted
by this License, of making, using, or selling its contributor version,
but do not include claims that would be infringed only as a
consequence of further modification of the contributor version. For
purposes of this definition, "control" includes the right to grant
patent sublicenses in a manner consistent with the requirements of
this License.
Each contributor grants you a non-exclusive, worldwide, royalty-free
patent license under the contributor's essential patent claims, to
make, use, sell, offer for sale, import and otherwise run, modify and
propagate the contents of its contributor version.
In the following three paragraphs, a "patent license" is any express
agreement or commitment, however denominated, not to enforce a patent
(such as an express permission to practice a patent or covenant not to
sue for patent infringement). To "grant" such a patent license to a
party means to make such an agreement or commitment not to enforce a
patent against the party.
If you convey a covered work, knowingly relying on a patent license,
and the Corresponding Source of the work is not available for anyone
to copy, free of charge and under the terms of this License, through a
publicly available network server or other readily accessible means,
then you must either (1) cause the Corresponding Source to be so
available, or (2) arrange to deprive yourself of the benefit of the
patent license for this particular work, or (3) arrange, in a manner
consistent with the requirements of this License, to extend the patent
license to downstream recipients. "Knowingly relying" means you have
actual knowledge that, but for the patent license, your conveying the
covered work in a country, or your recipient's use of the covered work
in a country, would infringe one or more identifiable patents in that
country that you have reason to believe are valid.
If, pursuant to or in connection with a single transaction or
arrangement, you convey, or propagate by procuring conveyance of, a
covered work, and grant a patent license to some of the parties
receiving the covered work authorizing them to use, propagate, modify
or convey a specific copy of the covered work, then the patent license
you grant is automatically extended to all recipients of the covered
work and works based on it.
A patent license is "discriminatory" if it does not include within
the scope of its coverage, prohibits the exercise of, or is
conditioned on the non-exercise of one or more of the rights that are
specifically granted under this License. You may not convey a covered
work if you are a party to an arrangement with a third party that is
in the business of distributing software, under which you make payment
to the third party based on the extent of your activity of conveying
the work, and under which the third party grants, to any of the
parties who would receive the covered work from you, a discriminatory
patent license (a) in connection with copies of the covered work
conveyed by you (or copies made from those copies), or (b) primarily
for and in connection with specific products or compilations that
contain the covered work, unless you entered into that arrangement,
or that patent license was granted, prior to 28 March 2007.
Nothing in this License shall be construed as excluding or limiting
any implied license or other defenses to infringement that may
otherwise be available to you under applicable patent law.
12. No Surrender of Others' Freedom.
If conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot convey a
covered work so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you may
not convey it at all. For example, if you agree to terms that obligate you
to collect a royalty for further conveying from those to whom you convey
the Program, the only way you could satisfy both those terms and this
License would be to refrain entirely from conveying the Program.
13. Use with the GNU Affero General Public License.
Notwithstanding any other provision of this License, you have
permission to link or combine any covered work with a work licensed
under version 3 of the GNU Affero General Public License into a single
combined work, and to convey the resulting work. The terms of this
License will continue to apply to the part which is the covered work,
but the special requirements of the GNU Affero General Public License,
section 13, concerning interaction through a network will apply to the
combination as such.
14. Revised Versions of this License.
The Free Software Foundation may publish revised and/or new versions of
the GNU General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the
Program specifies that a certain numbered version of the GNU General
Public License "or any later version" applies to it, you have the
option of following the terms and conditions either of that numbered
version or of any later version published by the Free Software
Foundation. If the Program does not specify a version number of the
GNU General Public License, you may choose any version ever published
by the Free Software Foundation.
If the Program specifies that a proxy can decide which future
versions of the GNU General Public License can be used, that proxy's
public statement of acceptance of a version permanently authorizes you
to choose that version for the Program.
Later license versions may give you additional or different
permissions. However, no additional obligations are imposed on any
author or copyright holder as a result of your choosing to follow a
later version.
15. Disclaimer of Warranty.
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
16. Limitation of Liability.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
17. Interpretation of Sections 15 and 16.
If the disclaimer of warranty and limitation of liability provided
above cannot be given local legal effect according to their terms,
reviewing courts shall apply local law that most closely approximates
an absolute waiver of all civil liability in connection with the
Program, unless a warranty or assumption of liability accompanies a
copy of the Program in return for a fee.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
state the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
Also add information on how to contact you by electronic and paper mail.
If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:
<program> Copyright (C) <year> <name of author>
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, your program's commands
might be different; for a GUI interface, you would use an "about box".
You should also get your employer (if you work as a programmer) or school,
if any, to sign a "copyright disclaimer" for the program, if necessary.
For more information on this, and how to apply and follow the GNU GPL, see
<https://www.gnu.org/licenses/>.
The GNU General Public License does not permit incorporating your program
into proprietary programs. If your program is a subroutine library, you
may consider it more useful to permit linking proprietary applications with
the library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License. But first, please read
<https://www.gnu.org/licenses/why-not-lgpl.html>.
-3
View File
@@ -1,3 +0,0 @@
class Echo:
def __init__(self, *args, **kwargs):
print(*args, **kwargs)
-23
View File
@@ -1,23 +0,0 @@
from cli.echo import Echo
class CustomDialog:
def __init__(self, message, msg_type="", timeout=None):
self.message = message
self.msg_type = msg_type.lower()
self.timeout = timeout
def mainloop(self):
if self.msg_type == "success":
Echo("✅", self.message)
elif self.msg_type == "error":
Echo("❌", self.message)
elif self.msg_type == "warning":
Echo("⚠️", self.message)
elif self.msg_type == "info":
Echo("ℹ", self.message)
else:
Echo(self.message)
def close(self):
pass
-214
View File
@@ -1,214 +0,0 @@
import getpass
import os
import re
from core.config import Config
from cli.info import CustomDialog
from core.constants import *
class LoginForm:
def __init__(
self,
config: Config,
on_login_callback=None,
on_quit_callback=None,
):
self.config = config
self.on_login_callback = on_login_callback
self.on_quit_callback = on_quit_callback
@staticmethod
def remove_trailing_slash(entry):
return re.sub(r"/+$", "", entry)
@staticmethod
def is_positive_integer(value):
if value.isdigit() and int(value) > 0:
return True
else:
return False
@staticmethod
def bool_to_str(value):
return "y" if value else "n"
@staticmethod
def str_to_bool(value):
return value.lower().strip() == "y"
@staticmethod
def is_positive_integer(value):
if value.isdigit() and int(value) > 0:
return True
else:
return False
def mainloop(self):
# save data to config
self.config.data["username"] = (
input(f"username [{self.config.data['username']}]: ")
or self.config.data["username"]
)
self.config.data["password"] = getpass.getpass("password: ")
server_url = (
input(f"server url [{self.config.data['server_url']}]: ")
or self.config.data["server_url"]
)
self.config.data["server_url"] = LoginForm.remove_trailing_slash(
server_url.strip()
)
self.config.data["cipher_enabled"] = LoginForm.str_to_bool(
input(
f"enabled encryption(recommended) [{LoginForm.bool_to_str(self.config.data['cipher_enabled'])}]: "
)
or LoginForm.bool_to_str(self.config.data["cipher_enabled"])
)
self.config.data["notification"] = LoginForm.str_to_bool(
input(
f"enabled notification [{LoginForm.bool_to_str(self.config.data['notification'])}]: "
)
or LoginForm.bool_to_str(self.config.data["notification"])
)
# extra fields
show_extra_fields = input(f"show extra fields [n]: ") or "n"
if not LoginForm.str_to_bool(show_extra_fields):
CustomDialog("Logging in...").mainloop()
return
# Validate hash_rounds
while True:
hash_rounds = input(
f"hash rounds [{self.config.data['hash_rounds']}]: "
) or str(
""
if self.config.data["hash_rounds"] is None
else str(self.config.data["hash_rounds"])
)
hash_rounds = hash_rounds.strip()
if not LoginForm.is_positive_integer(hash_rounds):
CustomDialog(
"Invalid Input\nHash Rounds must be a positive integer.",
msg_type="error",
)
continue
self.config.data["hash_rounds"] = int(hash_rounds)
break
self.config.data["salt"] = (
input(f"salt [{self.config.data['salt']}]: ") or self.config.data["salt"]
)
self.config.data["save_password"] = LoginForm.str_to_bool(
input(
f"store password locally(not recommended; only works if encryption is disabled) [{LoginForm.bool_to_str(self.config.data['save_password'])}]: "
)
or LoginForm.bool_to_str(self.config.data["save_password"])
)
# Validate max_clipboard_size_local_limit_bytes
while True:
saved_mcsll = str(
""
if self.config.data["max_clipboard_size_local_limit_bytes"] is None
else str(self.config.data["max_clipboard_size_local_limit_bytes"])
)
max_clipboard_size_local_limit_bytes = (
input(
f"maximum clipboard size local limit (in bytes) [{saved_mcsll}]: "
)
or saved_mcsll
)
max_clipboard_size_local_limit_bytes = (
max_clipboard_size_local_limit_bytes.strip()
)
if max_clipboard_size_local_limit_bytes == "":
self.config.data["max_clipboard_size_local_limit_bytes"] = None
break
if not LoginForm.is_positive_integer(max_clipboard_size_local_limit_bytes):
CustomDialog(
"Invalid Input\nMax Clipboard Size Local Limit must be a positive integer.",
msg_type="error",
)
continue
self.config.data["max_clipboard_size_local_limit_bytes"] = int(
max_clipboard_size_local_limit_bytes
)
break
self.config.data["enable_image_sharing"] = LoginForm.str_to_bool(
input(
f"enable image sharing [{LoginForm.bool_to_str(self.config.data['enable_image_sharing'])}]: "
)
or LoginForm.bool_to_str(self.config.data["enable_image_sharing"])
)
self.config.data["enable_file_sharing"] = LoginForm.str_to_bool(
input(
f"enable file sharing [{LoginForm.bool_to_str(self.config.data['enable_file_sharing'])}]: "
)
or LoginForm.bool_to_str(self.config.data["enable_file_sharing"])
)
# Validate default file download location
while True:
default_file_download_location = (
input(
f"default file download location [{self.config.data['default_file_download_location']}]: "
)
or self.config.data["default_file_download_location"]
)
default_file_download_location = default_file_download_location.strip()
if default_file_download_location == "":
self.config.data["default_file_download_location"] = ""
break
if not os.path.isdir(default_file_download_location):
CustomDialog(
"Invalid directory path.",
msg_type="error",
).mainloop()
continue
self.config.data["default_file_download_location"] = (
default_file_download_location
)
break
while True:
ssl_ca_bundle = (
input(
f"ssl ca bundle path (optional) [{self.config.data.get('ssl_ca_bundle') or ''}]: "
)
or (self.config.data.get("ssl_ca_bundle") or "")
).strip()
if ssl_ca_bundle == "":
self.config.data["ssl_ca_bundle"] = ""
break
if not os.path.isfile(ssl_ca_bundle):
CustomDialog(
"Invalid Input\nSSL CA bundle path is not a file or does not exist.",
msg_type="error",
).mainloop()
continue
self.config.data["ssl_ca_bundle"] = ssl_ca_bundle
break
CustomDialog("Logging in...").mainloop()
def on_quit(self):
pass
def close(self):
pass
-4
View File
@@ -1,4 +0,0 @@
class MessageBox:
def askquestion(self, title, message):
response = input(f"{title}\n{message} (y/n): ").strip().lower()
return "yes" if (response.lower().strip() == "y") else "no"
-367
View File
@@ -1,367 +0,0 @@
import math
import os
import threading
import time
import webbrowser
from cli.echo import Echo
from cli.info import CustomDialog
from core.config import Config
from core.constants import *
from itertools import count
if PLATFORM != WINDOWS:
import subprocess
class TaskbarPanel:
def __init__(
self,
on_connect_callback: callable = None,
on_disconnect_callback: callable = None,
on_logoff_callback: callable = None,
new_version_available: list = None,
github_url: str = GITHUB_URL,
donation_url: str = None,
ws_interface=None, # type= interfaces.ws_interface.WSInterface
config: Config = None,
):
self.on_connect_callback = on_connect_callback
self.on_disconnect_callback = on_disconnect_callback
self.on_logoff_callback = on_logoff_callback
self.new_version_available = new_version_available
self.github_url = github_url
self.donation_url = donation_url
self.ws_interface = ws_interface
self.config = config
self.is_disconnecting = False
self.disconnecting_items = None
self.is_file_download_enabled = False
self.file_download_items = None
self.previous_stats: str = ""
self.previous_stats_items = None
# Initial state: Connected
self.is_connected = True
self.menu_items = None
self.numbered_menu = None
self.loop_terminate = False
self.update_stats() # Start the stats update thread
def run(self):
Echo("-" * 53)
self.menu_items, self.numbered_menu = self.create_menu()
while not self.loop_terminate:
Echo("\n")
self.display_menu()
# input
choice = input("Choice: \n")
Echo("Please wait...")
if choice == "": # refresh
continue
if choice.isdigit():
choice = int(choice)
else:
Echo("Invalid choice. Please enter a number.")
if choice in self.numbered_menu:
fun = self.numbered_menu[choice][1]
if fun is not None:
fun()
else:
Echo("Invalid choice.")
def get_max_width(self):
"""Determine the maximum width of menu item texts."""
menu_texts = [
item[0] if isinstance(item, tuple) else "" for item in self.menu_items
]
return max(len(text) for text in menu_texts) + 1
def display_menu(self):
counter = count(1)
max_width = self.get_max_width()
total_width = max_width + 8
# Box Top Border
print("\n╔" + "═" * (max_width + 6) + "╗")
print(f"║{' MAIN MENU ':^{max_width + 6}}║")
print("╠" + "═" * (max_width + 6) + "╣")
# Menu Items
for item in self.menu_items:
if isinstance(item, tuple):
width = max_width
if "disconnect" in item[0].lower() or "logs" in item[0].lower():
if "disconnecting" in item[0].lower():
width -= 1
else:
width += 1
else:
width -= 1
print(f"║ {next(counter):<2}. {item[0]:<{width}} ║")
else:
print(f"║ {'─' * (max_width + 4)} ║")
# Box Bottom Border
print("╚" + "═" * (max_width + 6) + "╝")
def create_menu(self, item_: tuple = None):
# Menu items
menu_items = [
"", # Menu Separator
("🗒️ Open Logs", self._open_logs),
("📂 Program Files", self._open_program_location),
"", # Menu Separator
("🏠 Homepage", self._open_homepage),
("❓ Help", self._open_help),
("💟 Donate", self._open_donate),
("🌐 GitHub", self._open_github),
"", # Menu Separator
("🔒 Logoff and Quit", self._on_logoff),
("❌ Quit", self._on_quit),
]
# Add connect/disconnect option (top of the menu - 0 index)
if not self.is_connected:
menu_items.insert(0, ("🔗 Connect", self._on_connect))
else:
if self.is_disconnecting and self.disconnecting_items is not None:
menu_items.insert(
self.disconnecting_items[1],
(self.disconnecting_items[0], self.disconnecting_items[2]),
)
else:
menu_items.insert(0, ("⛓️‍💥 Disconnect", self._on_disconnect))
# Add update option (before the last 3 items)
if self.new_version_available is not None and self.new_version_available[0]:
menu_items.insert(
len(menu_items) - 3,
(
f"🔄 Update ({self.new_version_available[2]} ➞ {self.new_version_available[1]})",
self._on_update,
),
)
# Add files download option (top of the menu - 0 index)
if self.is_file_download_enabled and self.file_download_items is not None:
menu_items.insert(
self.file_download_items[1],
(self.file_download_items[0], self.file_download_items[2]),
)
# Add stats option (top of the menu - 0 index)
if self.previous_stats_items is not None:
menu_items.insert(
self.previous_stats_items[1],
(self.previous_stats_items[0], self.previous_stats_items[2]),
)
# Create numbered menu
counter = count(1)
numbered_menu = {
next(counter): item for item in menu_items if isinstance(item, tuple)
}
return (menu_items, numbered_menu)
def update_menu(self, item_: tuple = None, no_dialog=False):
self.menu_items, self.numbered_menu = self.create_menu(item_=item_)
if not no_dialog:
CustomDialog(
"Menu Updated! Press Enter to Refresh. ⏎", msg_type="info"
).mainloop()
def update_stats(self):
threading.Thread(target=self._update_stats_thread, daemon=True).start()
def _update_stats_thread(self):
while True:
current_stats = self.ws_interface.get_stats()
if current_stats is not None and self.previous_stats != current_stats:
self.previous_stats = current_stats
self.previous_stats_items = (current_stats, 0, None)
self.update_menu(no_dialog=True)
time.sleep(1) # Sleep for 1 second
@staticmethod
def open_webbrowser(url):
try:
webbrowser.open(url)
except Exception as e:
CustomDialog(
f"Failed to open the browser. Here is the URL: {url}\nError: {e}",
msg_type="error",
).mainloop()
def _on_update(self):
TaskbarPanel.open_webbrowser(self.new_version_available[3])
def _on_connect(self):
if self.on_connect_callback:
try:
self.on_connect_callback()
except Exception as e:
pass
self.is_connected = True
self.update_menu(no_dialog=True)
def _on_disconnect(self):
if self.on_disconnect_callback:
self.on_disconnect_callback()
if self.ws_interface is not None and self.ws_interface.is_auto_reconnecting:
threading.Thread(target=self._wait_to_disconnect, daemon=True).start()
else:
self.is_connected = False
self.update_menu(no_dialog=True)
def _wait_to_disconnect(self):
"""
Wait for the auto-reconnect timer to expire before disconnecting.
"""
if self.ws_interface is None:
return
timeout = math.ceil(self.ws_interface.get_total_timeout() / 1000)
while timeout > 0:
self.is_disconnecting = True
self.disconnecting_items = (
f"⏳ Disconnecting... ({timeout} sec)",
0,
None,
) # text, location, callback
self.update_menu(no_dialog=True)
time.sleep(1) # seconds
timeout -= 1
self.is_disconnecting = False
self.disconnecting_items = None
self.ws_interface.is_auto_reconnecting = False
self.is_connected = False
self.update_menu()
def _open_homepage(self):
TaskbarPanel.open_webbrowser(self.config.data["server_url"])
def _open_github(self):
TaskbarPanel.open_webbrowser(self.github_url)
def _open_help(self):
TaskbarPanel.open_webbrowser(HELP_URL)
def _open_donate(self):
if self.donation_url is not None:
TaskbarPanel.open_webbrowser(self.donation_url)
def open_location(self, path):
if PLATFORM == WINDOWS:
os.startfile(path)
elif PLATFORM == MACOS:
subprocess.run(["open", path])
elif PLATFORM.startswith(LINUX):
subprocess.run(["xdg-open", path])
def _open_logs(self):
log_file_path = os.path.join(get_program_files_directory(), LOG_FILE_NAME)
if os.path.exists(log_file_path):
try:
self.open_location(log_file_path)
except Exception as e:
CustomDialog(
f"Failed to open the log file '{log_file_path}'.\nError: {e}",
msg_type="error",
).mainloop()
else:
CustomDialog(
f"Log file not found at '{log_file_path}'.", msg_type="error"
).mainloop()
def _open_program_location(self):
try:
program_location = get_program_files_directory()
self.open_location(program_location)
except Exception as e:
CustomDialog(
f"Failed to open the program location '{program_location}'.\nError: {e}",
msg_type="error",
).mainloop()
def enable_files_download(self, files):
self.is_file_download_enabled = True
self.file_download_items = (
"📥 Download File(s)",
0,
lambda: self._on_download(files),
)
self.update_menu()
def disable_files_download(self):
self.is_file_download_enabled = False
self.file_download_items = None
self.update_menu()
def _on_download(self, files):
try:
if self.config.data["default_file_download_location"] != "":
target_directory = self.config.data["default_file_download_location"]
else:
target_directory = input("Enter the location to save file(s): ").strip()
if not target_directory:
CustomDialog(
"No input provided. Please enter a valid directory path.",
msg_type="error",
).mainloop()
return
if not os.path.isdir(target_directory):
CustomDialog("Invalid directory path.", msg_type="error").mainloop()
return
if not os.access(target_directory, os.W_OK):
CustomDialog(
"Insufficient permissions to write to the directory.",
msg_type="error",
).mainloop()
return
CustomDialog(
f"Saving files to: {target_directory}", msg_type="info"
).mainloop()
# Save each file to the chosen directory
for filename, file_obj in files.items():
file_path = os.path.join(target_directory, filename)
with open(file_path, "wb") as f:
f.write(file_obj.getvalue())
logging.debug(f"Saved: {file_path}")
CustomDialog("Done.", msg_type="success").mainloop()
except Exception as e:
msg = f"An error occurred while downloading files. Error: {e}"
logging.error(msg)
CustomDialog(
msg,
msg_type="error",
).mainloop()
def _on_logoff(self):
try:
if self.on_logoff_callback:
self.on_logoff_callback()
self._on_quit()
except Exception as e:
CustomDialog(
f"An error occurred while logging off: {e}", msg_type="error"
).mainloop()
def _on_quit(self):
self.loop_terminate = True
-464
View File
@@ -1,464 +0,0 @@
import base64
import io
import json
import logging
import os
import xxhash
from PIL import Image
from core.constants import *
from core.config import Config
if PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI:
from cli.tray import TaskbarPanel
else:
from gui.tray import TaskbarPanel
if PLATFORM == WINDOWS or PLATFORM == MACOS:
import pyperclip
if PLATFORM == WINDOWS:
import win32clipboard
from clipboard import clipboard_monitor_win as clipboard_monitor
elif PLATFORM == MACOS:
import pasteboard
from clipboard import clipboard_monitor_mac as clipboard_monitor
elif PLATFORM.startswith(LINUX):
from clipboard import clipboard_monitor_linux as clipboard_monitor
import subprocess
class ClipboardManager:
def __init__(self, config: Config):
self.config = config
self.previous_clipboard_hash = 0
self.sys_tray: TaskbarPanel = None
self.is_files_download_enabled = False
if PLATFORM.startswith(LINUX) and XMODE:
self.is_x_clipboard_owner = clipboard_monitor.is_x_clipboard_owner()
def set_tray_ref(self, sys_tray: TaskbarPanel):
"""
Sets the system tray reference.
"""
self.sys_tray = sys_tray
def reset_files_download(self):
"""
Resets the files download flag and disables the download functionality in the system tray if enabled.
"""
if self.is_files_download_enabled:
self.is_files_download_enabled = False
if self.sys_tray:
self.sys_tray.disable_files_download()
@staticmethod
def hash_clipboard(clipboard: str) -> int:
return xxhash.xxh64(clipboard).intdigest()
def is_clipboard_size_within_limit(
self, clipboard_content: any, type_: str = "text"
) -> bool:
if clipboard_content is None:
raise ValueError("Clipboard content cannot be None")
content_size_in_bytes = None
if type_ == "text":
content_size_in_bytes = len(clipboard_content.encode("utf-8"))
elif type_ == "image":
content_size_in_bytes = ClipboardManager.get_image_size(
img=clipboard_content
)
elif type_ == "files":
content_size_in_bytes = ClipboardManager.calculate_cumulative_file_size(
files=clipboard_content
)
# Check if the content size exceeds the server limit
max_allowed_size = self.config.data["maxsize"]
if (
max_allowed_size is not None
and max_allowed_size >= 0
and content_size_in_bytes > max_allowed_size
):
logging.warning(
"Clipboard content size exceeds the maximum allowed limit. "
f"Allowed: {max_allowed_size} bytes, Found: {content_size_in_bytes} bytes."
)
return False
# Check if the content size exceeds the local limit
local_clipboard_size_limit = self.config.data[
"max_clipboard_size_local_limit_bytes"
]
if local_clipboard_size_limit is not None and local_clipboard_size_limit >= 0:
if content_size_in_bytes > local_clipboard_size_limit:
logging.warning(
"Clipboard content size exceeds the local allowed limit. "
f"Allowed: {local_clipboard_size_limit} bytes, Found: {content_size_in_bytes} bytes."
)
return False
return True
def has_clipboard_changed(self, payload: str) -> bool:
"""
Check if the clipboard content has changed by comparing the current hash
with the previous clipboard hash.
Parameters:
- payload: The current clipboard content.
Returns:
- True if the clipboard content has changed, False otherwise.
"""
current_clipboard_hash = ClipboardManager.hash_clipboard(payload)
if current_clipboard_hash != self.previous_clipboard_hash:
self.previous_clipboard_hash = current_clipboard_hash
return True
return False
def on_copy(self, copy_callback):
clipboard_monitor.on_update(
callback=lambda type_, content: self.clipboard_to_base64(
copy_callback, content, type_
),
enable_image_monitoring=self.config.data["enable_image_sharing"],
enable_file_monitoring=self.config.data["enable_file_sharing"],
)
def clipboard_to_base64(self, callback, content: any, type_: str = "text"):
try:
self.reset_files_download()
type_ = type_.lower()
if type_ == "text":
if self.is_clipboard_size_within_limit(content, type_):
callback(content, type_)
elif type_ == "image":
if isinstance(content, list):
if content is None or len(content) == 0:
raise ValueError(
"Clipboard image content cannot be None or empty"
)
content = Image.open(content[0])
if self.is_clipboard_size_within_limit(content, type_):
content_str = ClipboardManager.convert_image_to_base64(img=content)
callback(content_str, type_)
elif type_ == "files":
if PLATFORM.startswith(LINUX):
if content is not None and len(content) > 0:
temp = []
for path in content:
if path.startswith("file:"):
temp.append(path[5:])
else:
temp.append(path)
content = temp
if self.is_clipboard_size_within_limit(content, type_):
content_str = ClipboardManager.convert_files_to_base64(
file_paths=content
)
if content_str != "{}": # Check if the JSON string is empty
callback(content_str, type_)
except Exception as e:
logging.error(f"Failed to convert clipboard data to base64: {e}")
def base64_to_clipboard(self, base64_string: str, type_: str = "text"):
try:
if type_ == "text":
txt = base64_string
if self.is_clipboard_size_within_limit(txt, type_):
self.paste(txt, type_)
elif type_ == "image":
img = ClipboardManager.convert_base64_to_image(base64_img=base64_string)
if self.is_clipboard_size_within_limit(img, type_):
self.paste(img, type_)
elif type_ == "files":
file_objects = ClipboardManager.convert_base64_to_files(
base64_json=base64_string
)
if self.is_clipboard_size_within_limit(file_objects, type_):
self.paste(file_objects, type_)
except Exception as e:
logging.error(f"Failed to convert base64 data to clipboard: {e}")
@staticmethod
def execute_command(*args, input_data):
"""
Execute a command with input data.
Parameters:
- *args: Positional arguments for the command.
- input_data: Input data to be passed to the command.
"""
if PLATFORM.startswith(LINUX):
try:
subprocess.run(
args,
input=input_data,
check=True,
)
except Exception as e:
logging.error(f"Failed to execute command: {e}")
raise
def paste(self, payload: any, payload_type: str = "text"):
try:
self.reset_files_download()
if payload_type == "text":
if PLATFORM == WINDOWS or PLATFORM == MACOS:
pyperclip.copy(payload)
elif PLATFORM.startswith(LINUX):
if XMODE and self.is_x_clipboard_owner:
ClipboardManager.execute_command(
"xclip",
"-selection",
"clipboard",
input_data=payload.encode("utf-8"),
)
else:
ClipboardManager.execute_command(
"wl-copy",
input_data=payload.encode("utf-8"),
)
elif payload_type == "image":
if PLATFORM == WINDOWS:
# Save the image to a binary buffer in BMP format
with io.BytesIO() as output:
payload.convert("RGB").save(output, format="BMP")
bmp_data = output.getvalue()[14:] # Skip BMP header (14 bytes)
win32clipboard.OpenClipboard()
win32clipboard.EmptyClipboard()
clipboard_monitor.enable_block_image_once() # Block image copy to prevent deadlock
win32clipboard.SetClipboardData(win32clipboard.CF_DIB, bmp_data)
win32clipboard.CloseClipboard()
elif PLATFORM == MACOS:
# Save the image to a binary buffer in TIFF format
with io.BytesIO() as output:
payload.convert("RGB").save(output, format="TIFF")
tiff_data = output.getvalue()
clipboard_monitor.enable_block_image_once() # Block image copy to prevent deadlock
clipboard_monitor.write_to_pasteboard(tiff_data, pasteboard.TIFF)
elif PLATFORM.startswith(LINUX):
# Save the image to a binary buffer in PNG format
with io.BytesIO() as output:
payload.convert("RGB").save(output, format="PNG")
png_data = output.getvalue()
clipboard_monitor.enable_block_image_once() # Block image copy to prevent deadlock
if XMODE and self.is_x_clipboard_owner:
ClipboardManager.execute_command(
"xclip",
"-selection",
"clipboard",
"-t",
"image/png",
input_data=png_data,
)
else:
ClipboardManager.execute_command(
"wl-copy",
"--type",
"image/png",
input_data=png_data,
)
elif payload_type == "files":
if (
payload is not None
and isinstance(payload, dict)
and len(payload) > 0
):
if self.sys_tray is not None:
self.is_files_download_enabled = True
self.sys_tray.enable_files_download(files=payload)
except Exception as e:
logging.error(f"Failed to copy data to clipboard: {e}")
raise
def stop(self):
self.reset_files_download()
clipboard_monitor.stop()
@staticmethod
def calculate_cumulative_file_size(files: tuple | list | dict) -> int:
"""
Calculate the cumulative size of a list of files.
Args:
files (tuple or list): A tuple of file paths.
files (dict): A dictionary of files with file names as keys and file object as values.
Returns:
int: The cumulative size of the files in bytes.
Raises:
IOError: If a file cannot be read or processed.
"""
cumulative_size = 0
if isinstance(files, tuple | list):
for file_path in files:
try:
if os.path.isfile(file_path):
cumulative_size += os.path.getsize(file_path)
except Exception as e:
raise IOError(
f"Failed to calculate size for file '{file_path}' {e}."
) from e
if isinstance(files, dict):
for file_name, file_object in files.items():
try:
cumulative_size += file_object.getbuffer().nbytes
except Exception as e:
raise IOError(
f"Failed to calculate size for file '{file_name}' {e}."
) from e
return cumulative_size
@staticmethod
def convert_files_to_base64(file_paths: tuple | list) -> str:
"""
Converts a list of files to base64-encoded strings and returns them as a JSON string.
Args:
file_paths (tuple or list): A tuple of file paths to be converted.
Returns:
str: A JSON string where file names are keys and base64-encoded content is values.
Raises:
IOError: If a file cannot be read or processed.
"""
base64_encoded_files = {}
for file_path in file_paths:
try:
if os.path.isfile(file_path):
file_name = os.path.basename(file_path)
with open(file_path, "rb") as file:
encoded_string = base64.b64encode(file.read()).decode("utf-8")
base64_encoded_files[file_name] = encoded_string
except Exception as e:
raise IOError(f"Failed to process file '{file_path}'. {e}") from e
return json.dumps(base64_encoded_files)
@staticmethod
def convert_base64_to_files(base64_json: dict) -> dict:
"""
Converts a JSON string with base64-encoded file content to a dictionary of file-like objects.
Args:
base64_json (str): A JSON string where file names are keys and base64-encoded content is values.
Returns:
dict: A dictionary where keys are file names, and values are BytesIO objects containing the decoded file data.
"""
file_objects = {}
try:
base64_data = json.loads(base64_json)
for file_name, encoded_content in base64_data.items():
decoded_content = base64.b64decode(encoded_content)
file_objects[file_name] = io.BytesIO(decoded_content)
except Exception as e:
raise IOError(f"Error processing base64 JSON. {e}") from e
return file_objects
@staticmethod
def get_image_size(img: Image.Image | bytes) -> int:
"""
Calculate the size of an image in bytes.
Args:
img (Image.Image | bytes): The image to calculate the size for.
Returns:
int: The size of the image in bytes.
Raises:
IOError: If the image cannot be processed or saved.
"""
try:
if isinstance(img, bytes):
size_in_bytes = len(img)
if isinstance(img, Image.Image):
with io.BytesIO() as buffer:
img.save(buffer, format=img.format or "PNG")
size_in_bytes = buffer.tell()
return size_in_bytes
except Exception as e:
raise IOError(f"Failed to calculate the image size. {e}") from e
@staticmethod
def convert_image_to_base64(img: Image.Image | bytes) -> str:
"""
Converts an image to a base64-encoded string.
Args:
img (Image.Image | bytes): The image to be converted.
Returns:
str: The base64-encoded string representation of the image.
Raises:
IOError: If the image cannot be processed or saved.
"""
try:
if isinstance(img, bytes):
base64_string = base64.b64encode(img).decode("utf-8")
if isinstance(img, Image.Image):
with io.BytesIO() as buffered:
img.save(buffered, format=img.format or "PNG")
base64_string = base64.b64encode(buffered.getvalue()).decode(
"utf-8"
)
return base64_string
except Exception as e:
raise IOError(f"Failed to convert the image to base64. {e}") from e
@staticmethod
def convert_base64_to_image(base64_img: str) -> Image.Image:
"""
Converts a base64-encoded string to a PIL Image object.
Args:
base64_img (str): The base64-encoded string to be converted.
Returns:
Image.Image: A PIL Image object representing the decoded image.
Raises:
ValueError: If the base64 string is invalid.
IOError: If the image cannot be processed.
"""
try:
# Decode the base64 string
image_data = base64.b64decode(base64_img)
except base64.binascii.Error as e:
raise ValueError("Invalid base64 string.") from e
try:
# Load the image from the decoded bytes
with io.BytesIO(image_data) as image_stream:
image = Image.open(image_stream)
image.load()
return image
except IOError as e:
raise IOError(f"Failed to process the image. {e}") from e
@@ -1,486 +0,0 @@
import logging
import re
import subprocess
import threading
import time
from core.constants import *
_callback_update = None
_clipboard_thread = None
_block_image_once = False
_is_gdk_running = False
_run_poll = threading.Event()
_wl_watch_proc = None
def _on_clipboard_changed(
clipboard, event=None, enable_image_monitoring=False, enable_file_monitoring=False
):
global _block_image_once
# Files
if enable_file_monitoring:
uris = clipboard.wait_for_uris()
if uris is not None and len(uris) > 0:
if _callback_update:
_callback_update("files", uris)
return
# Text
text = clipboard.wait_for_text()
if text is not None and len(text) > 0:
if _callback_update:
_callback_update("text", text)
return
# Image
if enable_image_monitoring:
pixbuf = clipboard.wait_for_image()
if pixbuf is not None:
if _block_image_once:
_block_image_once = False
return
if _callback_update:
success, buffer = pixbuf.save_to_bufferv("png")
if success:
_callback_update("image", bytes(buffer))
else:
logging.error("Failed to convert image(pixbuf) to buffer")
return
def _monitor_x_wl_clipboard(
x_mode: bool,
enable_image_monitoring=False,
enable_file_monitoring=False,
):
global _block_image_once
last_error = None
previous_clipboard: str | bytes | None = None
ignore_patterns = [
r"target .+ not available", # xclip pattern
r"no suitable type of content copied", # wl-clipboard pattern
]
if LINUX_CLIPBOARD_POLL_INTERVAL_SEC is not None:
timeout = LINUX_CLIPBOARD_POLL_INTERVAL_SEC
logging.info(f"Clipboard polling interval (--polling): {timeout}s")
elif x_mode:
timeout = 0.3 # xclip seconds
else:
timeout = 3 # wl-clipboard seconds
while _run_poll.is_set():
if x_mode:
success, mime_list = execute_command(
"xclip", "-selection", "clipboard", "-t", "TARGETS", "-o"
)
else:
success, mime_list = execute_command("wl-paste", "-l")
if not success:
error_msg = f"Failed to retrieve MIME types: {mime_list}"
if error_msg != last_error:
logging.error(error_msg)
last_error = error_msg
time.sleep(timeout)
continue
mime_list = mime_list.decode("utf-8")
mime_list = mime_list.replace("\r\n", "\n").replace("\r", "\n").split("\n")
mime_list = [m.strip() for m in mime_list if len(m.strip()) > 0]
type_ = convert_mime_to_generic_type(mime_list)
# Text
if type_ == "text":
if x_mode:
success, text = execute_command(
"xclip", "-selection", "clipboard", "-o"
)
else:
success, text = execute_command("wl-paste", "-n")
if success:
text = text.decode("utf-8")
if len(text) > 0 and text != previous_clipboard:
previous_clipboard = text
if _callback_update:
_callback_update("text", text)
else:
error_msg = f"Failed to retrieve text content from clipboard. {text}"
if error_msg != last_error:
if not any(
re.search(pattern, error_msg.lower())
for pattern in ignore_patterns
):
logging.error(error_msg)
last_error = error_msg
# Image
if type_ == "image" and enable_image_monitoring:
if x_mode:
success, image = execute_command(
"xclip",
"-selection",
"clipboard",
"-t",
"image/png",
"-o",
)
else:
success, image = execute_command("wl-paste", "-t", "image/png")
if success:
if image != previous_clipboard:
previous_clipboard = image
if _callback_update and not _block_image_once:
_callback_update("image", image)
else:
_block_image_once = False
else:
error_msg = f"Failed to retrieve image content from clipboard. {image}"
if error_msg != last_error:
if not any(
re.search(pattern, error_msg.lower())
for pattern in ignore_patterns
):
logging.error(error_msg)
last_error = error_msg
# Files
if type_ == "files" and enable_file_monitoring:
if x_mode:
success, files = execute_command(
"xclip",
"-selection",
"clipboard",
"-t",
"text/uri-list",
"-o",
)
else:
success, files = execute_command(
"wl-paste", "-t", "text/uri-list", "-n"
)
if success:
files = files.decode("utf-8")
files = files.replace("\r\n", "\n").replace("\r", "\n").split("\n")
files = [f.strip() for f in files if len(f.strip()) > 0]
if files != previous_clipboard:
previous_clipboard = files
if _callback_update:
_callback_update("files", files)
else:
error_msg = f"Failed to retrieve files content from clipboard. {files}"
if error_msg != last_error:
if not any(
re.search(pattern, error_msg.lower())
for pattern in ignore_patterns
):
logging.error(error_msg)
last_error = error_msg
time.sleep(timeout)
def _monitor_wl_watch(enable_image_monitoring=False, enable_file_monitoring=False):
"""Event-driven Wayland clipboard monitoring using wl-paste --watch.
Uses the wlr-data-control-v1 protocol which does not create visible
surfaces or steal focus. Supported by wlroots-based compositors
(Sway, Hyprland, etc.) and KDE Plasma on Wayland.
Returns True if watch mode ran successfully, False to fall back to polling."""
global _block_image_once, _wl_watch_proc
last_error = None
previous_clipboard = None
ignore_patterns = [
r"target .+ not available",
r"no suitable type of content copied",
]
try:
_wl_watch_proc = subprocess.Popen(
["wl-paste", "--watch", "echo"],
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
)
time.sleep(0.5)
if _wl_watch_proc.poll() is not None:
stderr_out = _wl_watch_proc.stderr.read().decode("utf-8", errors="ignore")
logging.warning(
f"wl-paste --watch exited immediately: {stderr_out.strip()}"
)
_wl_watch_proc = None
return False
logging.info(
"Using wl-paste --watch for clipboard monitoring (no focus stealing)"
)
while _run_poll.is_set():
line = _wl_watch_proc.stdout.readline()
if not line:
break
if not _run_poll.is_set():
break
success, mime_output = execute_command("wl-paste", "-l")
if not success:
error_msg = f"Failed to retrieve MIME types: {mime_output}"
if error_msg != last_error:
logging.error(error_msg)
last_error = error_msg
continue
mime_list = mime_output.decode("utf-8")
mime_list = mime_list.replace("\r\n", "\n").replace("\r", "\n").split("\n")
mime_list = [m.strip() for m in mime_list if len(m.strip()) > 0]
type_ = convert_mime_to_generic_type(mime_list)
# Text
if type_ == "text":
success, text = execute_command("wl-paste", "-n")
if success:
text = text.decode("utf-8")
if len(text) > 0 and text != previous_clipboard:
previous_clipboard = text
if _callback_update:
_callback_update("text", text)
else:
error_msg = (
f"Failed to retrieve text content from clipboard. {text}"
)
if error_msg != last_error:
if not any(
re.search(pattern, error_msg.lower())
for pattern in ignore_patterns
):
logging.error(error_msg)
last_error = error_msg
# Image
elif type_ == "image" and enable_image_monitoring:
success, image = execute_command("wl-paste", "-t", "image/png")
if success:
if image != previous_clipboard:
previous_clipboard = image
if _callback_update and not _block_image_once:
_callback_update("image", image)
else:
_block_image_once = False
else:
error_msg = (
f"Failed to retrieve image content from clipboard. {image}"
)
if error_msg != last_error:
if not any(
re.search(pattern, error_msg.lower())
for pattern in ignore_patterns
):
logging.error(error_msg)
last_error = error_msg
# Files
elif type_ == "files" and enable_file_monitoring:
success, files = execute_command(
"wl-paste", "-t", "text/uri-list", "-n"
)
if success:
files = files.decode("utf-8")
files = (
files.replace("\r\n", "\n").replace("\r", "\n").split("\n")
)
files = [f.strip() for f in files if len(f.strip()) > 0]
if files != previous_clipboard:
previous_clipboard = files
if _callback_update:
_callback_update("files", files)
else:
error_msg = (
f"Failed to retrieve files content from clipboard. {files}"
)
if error_msg != last_error:
if not any(
re.search(pattern, error_msg.lower())
for pattern in ignore_patterns
):
logging.error(error_msg)
last_error = error_msg
return True
except FileNotFoundError:
logging.warning("wl-paste not found, cannot use --watch mode")
return False
except Exception as e:
logging.warning(f"wl-paste --watch failed: {e}")
return False
finally:
if _wl_watch_proc is not None:
_wl_watch_proc.terminate()
try:
_wl_watch_proc.wait(timeout=2)
except subprocess.TimeoutExpired:
_wl_watch_proc.kill()
_wl_watch_proc = None
def convert_mime_to_generic_type(mime_list):
if "text/uri-list" in mime_list:
return "files"
if any(mime.startswith("image/") for mime in mime_list):
return "image"
text_mime = [
"text/plain",
"text/plain;charset=utf-8",
"STRING",
"TEXT",
"COMPOUND_TEXT",
"UTF8_STRING",
]
if any(t_mime in mime_list for t_mime in text_mime):
return "text"
return "unknown"
def execute_command(*args) -> tuple:
"""
Executes a command with the given arguments and returns the output or error.
Parameters:
*args: Variable-length argument list to be passed as the command and arguments.
Returns:
tuple: (success: bool, result: str)
success is True if the command executed successfully, False otherwise.
result is the output or error of the command.
"""
process = subprocess.Popen(
args,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
)
output, error = process.communicate()
if process.returncode == 0: # Success
return (True, output)
else: # Failure
return (False, error.decode())
def is_x_clipboard_owner():
# Check if the X clipboard is owned by the current user
return execute_command("xclip", "-selection", "clipboard", "-t", "TARGETS", "-o")[0]
def _start_clipboard_polling(enable_image_monitoring, enable_file_monitoring):
if XMODE:
x_clipboard_owner = is_x_clipboard_owner()
if not x_clipboard_owner:
logging.warning(
"x-clip is not owned by the current user. Switching to wl-clipboard."
)
_monitor_x_wl_clipboard(
x_mode=x_clipboard_owner,
enable_image_monitoring=enable_image_monitoring,
enable_file_monitoring=enable_file_monitoring,
)
else:
if not _monitor_wl_watch(
enable_image_monitoring=enable_image_monitoring,
enable_file_monitoring=enable_file_monitoring,
):
logging.info(
"Falling back to wl-paste polling mode for clipboard monitoring"
)
_monitor_x_wl_clipboard(
x_mode=False,
enable_image_monitoring=enable_image_monitoring,
enable_file_monitoring=enable_file_monitoring,
)
def _runner(enable_image_monitoring=False, enable_file_monitoring=False):
global _is_gdk_running, _run_poll
logging.info(f"XMODE: {XMODE}")
try:
_run_poll.set()
import gi
gi.require_version("Gtk", "3.0")
gi.require_version("Gdk", "3.0")
from gi.repository import Gtk, Gdk
if "x11" in str(type(Gdk.Display.get_default())).lower(): # X11
logging.info("Starting GTK clipboard monitoring for X11 display server.")
clipboard = Gtk.Clipboard.get(Gdk.SELECTION_CLIPBOARD)
clipboard.connect(
"owner-change",
lambda clip, event: _on_clipboard_changed(
clip, event, enable_image_monitoring, enable_file_monitoring
),
)
_is_gdk_running = True
Gtk.main()
else:
logging.warning(
f"Unsupported display server detected ${str(type(Gdk.Display.get_default())).lower()}. Starting polling mode for {detect_linux_display_server()} server as fallback."
)
_start_clipboard_polling(enable_image_monitoring, enable_file_monitoring)
except Exception as e:
logging.error(
f"Failed to start clipboard monitor: Error {e}\nStarting polling mode for {detect_linux_display_server()} server as fallback."
)
_start_clipboard_polling(enable_image_monitoring, enable_file_monitoring)
def _start(enable_image_monitoring=False, enable_file_monitoring=False):
global _clipboard_thread
if not _clipboard_thread:
_clipboard_thread = threading.Thread(
target=_runner,
args=(enable_image_monitoring, enable_file_monitoring),
daemon=True,
)
_clipboard_thread.start()
def stop():
global _clipboard_thread, _callback_update, _block_image_once, _run_poll, _is_gdk_running, _wl_watch_proc
if _clipboard_thread:
if _is_gdk_running:
import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk
Gtk.main_quit()
_is_gdk_running = False
_run_poll.clear()
if _wl_watch_proc is not None:
_wl_watch_proc.terminate()
_clipboard_thread.join() # Wait for the thread to finish
_clipboard_thread = None
_callback_update = None
_block_image_once = False
_wl_watch_proc = None
logging.info("Clipboard monitor stopped")
def wait():
global _clipboard_thread
if _clipboard_thread:
_clipboard_thread.join()
def enable_block_image_once():
global _block_image_once
_block_image_once = True
def on_update(callback, enable_image_monitoring=False, enable_file_monitoring=False):
global _callback_update
_callback_update = callback
_start(enable_image_monitoring, enable_file_monitoring)
@@ -1,149 +0,0 @@
from io import BytesIO
import logging
import threading
import time
import pasteboard
_clipboard_thread = None
_callback_update = None
_run = False
_first_run = False
_block_image_once = False
_pasteboard_lock = threading.Lock()
_pb_writer = None
def write_to_pasteboard(data, pb_type):
global _pb_writer
with _pasteboard_lock:
if _pb_writer is None:
_pb_writer = pasteboard.Pasteboard()
_pb_writer.set_contents(data, pb_type)
def _runner(enable_image_monitoring=False, enable_file_monitoring=False):
global _first_run, _block_image_once
try:
pb_text = pasteboard.Pasteboard()
if enable_image_monitoring:
pb_image_png = pasteboard.Pasteboard()
pb_image_tiff = pasteboard.Pasteboard()
if enable_file_monitoring:
pb_files = pasteboard.Pasteboard()
image_processed = False
files_processed = False
while _run:
# don't change the execution order (files,text,image or files,image,text)
if enable_file_monitoring:
# Files
with _pasteboard_lock:
clipboard_files = pb_files.get_file_urls(diff=True)
if (
clipboard_files is not None
and type(clipboard_files) is tuple
and len(clipboard_files) > 0
):
if _callback_update and not _first_run:
files_processed = True
_callback_update("files", clipboard_files)
# Text
with _pasteboard_lock:
clipboard_text = pb_text.get_contents(
type=pasteboard.String, diff=True
) # If True, retrieves and returns the content only if it has changed since the last call.
# This approach is efficient even in cases of frequent polling.
if (
clipboard_text is not None
and type(clipboard_text) is str
and len(clipboard_text) > 0
):
if _callback_update and not _first_run and not files_processed:
_callback_update("text", clipboard_text)
if enable_image_monitoring:
# Image (PNG)
with _pasteboard_lock:
clipboard_image_png = pb_image_png.get_contents(
type=pasteboard.PNG, diff=True
)
if (
clipboard_image_png is not None
and type(clipboard_image_png) is bytes
):
if _callback_update and not _first_run and not image_processed:
image_processed = True
if _block_image_once:
_block_image_once = False
else:
if not files_processed:
_callback_update("image", clipboard_image_png)
# Image (TIFF)
with _pasteboard_lock:
clipboard_image_tiff = pb_image_tiff.get_contents(
type=pasteboard.TIFF, diff=True
)
if (
clipboard_image_tiff is not None
and type(clipboard_image_tiff) is bytes
):
if _callback_update and not _first_run and not image_processed:
image_processed = True
if _block_image_once:
_block_image_once = False
else:
if not files_processed:
_callback_update("image", clipboard_image_tiff)
files_processed = False
image_processed = False
_first_run = False
time.sleep(0.3) # seconds
except Exception as e:
logging.error(f"Error processing clipboard update: {e}")
def _start(enable_image_monitoring=False, enable_file_monitoring=False):
global _clipboard_thread, _run, _first_run
if not _clipboard_thread:
_run = True
_first_run = True
_clipboard_thread = threading.Thread(
target=_runner,
args=(enable_image_monitoring, enable_file_monitoring),
daemon=True,
)
_clipboard_thread.start()
def stop():
global _clipboard_thread, _callback_update, _run, _first_run, _block_image_once, _pb_writer
if _clipboard_thread:
_run = False
_clipboard_thread.join() # Wait for the thread to finish
_first_run = False
_clipboard_thread = None
_callback_update = None
_block_image_once = False
_pb_writer = None
logging.info("Clipboard monitor stopped")
def wait():
global _clipboard_thread
if _clipboard_thread:
_clipboard_thread.join()
def enable_block_image_once():
global _block_image_once
_block_image_once = True
def on_update(callback, enable_image_monitoring=False, enable_file_monitoring=False):
global _callback_update
_callback_update = callback
_start(enable_image_monitoring, enable_file_monitoring)
@@ -1,163 +0,0 @@
import logging
import win32gui
import win32api
import win32con
import win32clipboard
import threading
import ctypes
import time
from PIL import ImageGrab
_clipboard_thread = None
_hwnd = None # Store the window handle
_callback_update = None
_block_image_once = False
def _get_clipboard_content(enable_image_monitoring=False, enable_file_monitoring=False):
"""
Get the content of the clipboard.
Image:
PNG -> PngImagePlugin.PngImageFile
DIB -> BmpImagePlugin.DibImageFile
PNG, DIB, JPG, etc. -> [file_path1, file_path2, ...]
Text:
CF_UNICODETEXT, CF_TEXT -> str
Files:
CF_HDROP -> (file_path1, file_path2, ...)
"""
# sleep 0.5 to avoid clipboard not ready for read
time.sleep(0.5)
clipboard_type = None
clipboard_content = None
if enable_image_monitoring and win32clipboard.IsClipboardFormatAvailable(
win32con.CF_BITMAP
):
clipboard_type = "image"
clipboard_content = ImageGrab.grabclipboard()
else:
win32clipboard.OpenClipboard()
try:
if win32clipboard.IsClipboardFormatAvailable(win32con.CF_UNICODETEXT):
text = win32clipboard.GetClipboardData(win32con.CF_UNICODETEXT)
clipboard_type = "text"
clipboard_content = text
elif win32clipboard.IsClipboardFormatAvailable(win32con.CF_TEXT):
text_bytes = win32clipboard.GetClipboardData(win32con.CF_TEXT)
text = text_bytes.decode()
clipboard_type = "text"
clipboard_content = text
elif enable_file_monitoring and win32clipboard.IsClipboardFormatAvailable(
win32con.CF_HDROP
):
files = win32clipboard.GetClipboardData(win32con.CF_HDROP)
clipboard_type = "files"
clipboard_content = files
finally:
win32clipboard.CloseClipboard()
return (clipboard_type, clipboard_content)
def _process_message(
hwnd: int,
msg: int,
wparam: int,
lparam: int,
enable_image_monitoring=False,
enable_file_monitoring=False,
):
global _block_image_once
WM_CLIPBOARDUPDATE = 0x031D
if msg == WM_CLIPBOARDUPDATE:
clip = _get_clipboard_content(enable_image_monitoring, enable_file_monitoring)
try:
if clip[0] == "text" and _callback_update:
_callback_update(clip[0], clip[1])
if enable_image_monitoring and clip[0] == "image" and _callback_update:
if _block_image_once:
_block_image_once = False
else:
_callback_update(clip[0], clip[1])
if enable_file_monitoring and clip[0] == "files" and _callback_update:
_callback_update(clip[0], clip[1])
except Exception as e:
logging.error(f"Error processing clipboard update: {e}")
return 0
def _create_window(enable_image_monitoring=False, enable_file_monitoring=False):
global _hwnd
className = "ClipboardHook"
wc = win32gui.WNDCLASS()
wc.lpfnWndProc = lambda hwnd, msg, wparam, lparam: _process_message(
hwnd, msg, wparam, lparam, enable_image_monitoring, enable_file_monitoring
)
wc.lpszClassName = className
wc.hInstance = win32api.GetModuleHandle(None)
class_atom = win32gui.RegisterClass(wc)
_hwnd = win32gui.CreateWindow(
class_atom, className, 0, 0, 0, 0, 0, 0, 0, wc.hInstance, None
)
def _runner(enable_image_monitoring=False, enable_file_monitoring=False):
global _hwnd
_create_window(enable_image_monitoring, enable_file_monitoring)
ctypes.windll.user32.AddClipboardFormatListener(_hwnd)
try:
win32gui.PumpMessages()
finally:
ctypes.windll.user32.RemoveClipboardFormatListener(_hwnd)
win32gui.DestroyWindow(_hwnd)
win32gui.UnregisterClass("ClipboardHook", win32api.GetModuleHandle(None))
def _start(enable_image_monitoring=False, enable_file_monitoring=False):
global _clipboard_thread
if not _clipboard_thread:
_clipboard_thread = threading.Thread(
target=_runner,
args=(enable_image_monitoring, enable_file_monitoring),
daemon=True,
)
_clipboard_thread.start()
def stop():
global _clipboard_thread, _hwnd, _callback_update, _block_image_once
if _clipboard_thread and _hwnd:
win32gui.PostMessage(
_hwnd, win32con.WM_QUIT, 0, 0
) # Send WM_QUIT to the window
_clipboard_thread.join() # Wait for the thread to finish
_clipboard_thread = None
_hwnd = None
_callback_update = None
_block_image_once = False
logging.info("Clipboard monitor stopped")
def wait():
global _clipboard_thread
if _clipboard_thread:
_clipboard_thread.join()
def enable_block_image_once():
global _block_image_once
_block_image_once = True
def on_update(callback, enable_image_monitoring=False, enable_file_monitoring=False):
global _callback_update
_callback_update = callback
_start(enable_image_monitoring, enable_file_monitoring)
-309
View File
@@ -1,309 +0,0 @@
import logging
import sys
from core.constants import *
from core.config import Config
from utils.request_manager import RequestManager
from utils.cipher_manager import CipherManager
from stomp_ws.stomp_manager import STOMPManager
from p2p.p2p_manager import P2PManager
if PLATFORM == WINDOWS:
import ctypes
elif PLATFORM == MACOS or PLATFORM.startswith(LINUX):
import fcntl
if PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI:
import pyfiglet
from cli.login import LoginForm
from cli.info import CustomDialog
from cli.tray import TaskbarPanel
from cli.message_box import MessageBox
from cli.echo import Echo
else:
from gui.login import LoginForm
from gui.info import CustomDialog
from gui.tray import TaskbarPanel
from gui.message_box import MessageBox
class Application:
def __init__(
self,
log_file_path=LOG_FILE_NAME,
data_file_path=DATA_FILE_NAME,
mutex_identifier=MUTEX_NAME,
):
try:
self.log_file_path = os.path.join(
get_program_files_directory(), log_file_path
)
self.data_file_path = os.path.join(
get_program_files_directory(), data_file_path
)
self.mutex_identifier = mutex_identifier
if PLATFORM == MACOS or PLATFORM.startswith(LINUX):
self.lock_file = None # File(lock) object
self.mutex_identifier = os.path.join(
get_program_files_directory(), self.mutex_identifier
)
self.config = Config(
file_name=self.data_file_path
) # Maintain a single configuration instance for the entire application lifecycle.
self.request_manager = RequestManager(self.config)
self.stomp_manager = STOMPManager(self.config)
self.p2p_manager = P2PManager(self.config)
self.cipher_manager = CipherManager(self.config)
except Exception as e:
CustomDialog(
f"An error occurred during application initialization: {e}",
msg_type="error",
).mainloop()
def setup_logging(self):
LOG_FORMAT = "%(asctime)s - %(levelname)s - %(message)s"
logging.basicConfig(
level=LOG_LEVEL,
format=LOG_FORMAT,
filename=self.log_file_path,
filemode="w",
)
def ensure_single_instance(self):
if PLATFORM == WINDOWS:
ctypes.windll.kernel32.CreateMutexW(None, False, self.mutex_identifier)
if ctypes.windll.kernel32.GetLastError() == 183: # ERROR_ALREADY_EXISTS
CustomDialog(
"Another instance of ClipCascade is already running.",
msg_type="warning",
).mainloop()
sys.exit(0)
elif PLATFORM == MACOS or PLATFORM.startswith(LINUX):
if PLATFORM == MACOS:
app_dir = get_program_files_directory()
if not os.path.exists(app_dir):
try:
os.makedirs(app_dir)
except Exception as e:
CustomDialog(
f"An error occurred while creating the directory '{app_dir}'. Error: {e}",
msg_type="error",
).mainloop()
sys.exit(1)
# Create the lock file
try:
self.create_lock_file()
except IOError:
run_anyway = MessageBox().askquestion(
"ClipCascade",
"Another instance of ClipCascade is already running. Do you want to run anyway?",
)
if run_anyway == "yes":
os.remove(self.mutex_identifier)
self.create_lock_file()
else:
self.lock_file = None
sys.exit(0)
def create_lock_file(self, path=None):
if path is None:
path = self.mutex_identifier
if PLATFORM == MACOS or PLATFORM.startswith(LINUX):
self.lock_file = open(path, "w")
fcntl.flock(self.lock_file, fcntl.LOCK_EX | fcntl.LOCK_NB)
def authenticate_and_connect(self):
# Attempt to connect with existing cookie
if self.config.data.get("cookie"):
ws_conn_successful, msg = self._get_ws_manager().connect()
if ws_conn_successful:
self._get_ws_manager().is_login_phase = False
return
# enable login form
used_saved_credentials = False
display_login_success_dialog = False
if PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI:
Echo("═" * 14 + "\n║ LOGIN FORM ║\n" + "═" * 14)
while True:
if (
self.config.data.get("cookie") is not None
and self.config.data["save_password"]
and self.config.data["cipher_enabled"] == False
and not used_saved_credentials
):
# Attempt to connect with password when using saved credentials
used_saved_credentials = True
else:
display_login_success_dialog = True
self.config.data["password"] = "" # Clear the password
login_form = LoginForm(
self.config,
on_quit_callback=(
None
if (PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI)
else lambda: sys.exit(0)
),
)
login_form.mainloop() # wait until login form is closed
raw_password = self.config.data[
"password"
] # Store the raw password temporarily for hashing
self.config.data["password"] = (
CipherManager.string_to_sha3_512_lowercase_hex(raw_password)
) # Hash the password
login_successful, msg_login, self.config.data["cookie"] = (
self.request_manager.login()
)
if login_successful:
self.config.data["csrf_token"] = self.request_manager.get_csrf_token()
self.config.data["server_mode"] = self.request_manager.get_server_mode()
if self.config.data["server_mode"] == "P2P":
self.config.data["stun_url"] = self.request_manager.get_stun_url()
self.config.data["maxsize"] = -1
self.config.data["websocket_url"] = Config.convert_to_websocket_url(
self.config.data["server_url"], WEBSOCKET_ENDPOINT_P2P
)
else:
self.config.data["stun_url"] = ""
self.config.data["maxsize"] = self.request_manager.maxsize()
self.config.data["websocket_url"] = Config.convert_to_websocket_url(
self.config.data["server_url"], WEBSOCKET_ENDPOINT
)
ws_conn_successful, msg = self._get_ws_manager().connect()
if ws_conn_successful:
self._get_ws_manager().is_login_phase = False
if self.config.data["cipher_enabled"]:
self.config.data["hashed_password"] = (
self.cipher_manager.hash_password(raw_password)
)
if not self.config.data["save_password"]:
self.config.data["password"] = ""
if display_login_success_dialog:
CustomDialog(
"Success! ClipCascade will now run in the task bar/menu bar.",
msg_type="success",
timeout=5000,
).mainloop()
break
else:
CustomDialog(
"Login successful but websocket connection failed. \nPlease check websocket-url\n"
+ msg,
msg_type="error",
).mainloop()
else:
CustomDialog("Login Failed\n" + msg_login, msg_type="error").mainloop()
raw_password = None # Clear the raw password
if PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI:
Echo("-" * 53)
def _get_ws_manager(self):
if self.config.data["server_mode"] == "P2P":
return self.p2p_manager
else:
return self.stomp_manager
def get_version_update_status(self) -> list:
"""
Checks for a new version of the application by comparing the current version
with the one available in a remote JSON file.
Returns:
list: [bool, str, str, str] - [Is new version available, latest version, current version, release URL]
"""
try:
response = RequestManager.get(VERSION_URL)
response_data = response.json()
if PLATFORM == WINDOWS:
key = "windows"
elif PLATFORM == MACOS:
key = "macos"
elif PLATFORM.startswith(LINUX):
if not LINUX_USE_CLI_UI:
key = "linux_gui"
else:
key = "linux_non_gui"
if response_data[key] != APP_VERSION:
return [True, response_data[key], APP_VERSION, RELEASE_URL]
except Exception as e:
logging.error(f"Error checking for new version: {e}")
return [False, "", APP_VERSION, RELEASE_URL]
def get_donation_url(self) -> str:
try:
metadata = self.request_manager.get_metadata()
if metadata is not None:
return metadata.get("funding", None)
except Exception as e:
logging.error(f"Error fetching metadata: {e}")
return None
def logoff_and_exit(self):
try:
self._get_ws_manager().disconnect()
self.request_manager.logout()
self.config.data["hashed_password"] = None
self.config.data["cookie"] = None
self.config.data["maxsize"] = None
self.config.data["password"] = ""
self.config.data["csrf_token"] = ""
self.config.save()
except Exception as e:
raise Exception(f"Error during logging off: {e}")
def banner(self):
if PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI:
Echo(pyfiglet.figlet_format(APP_NAME))
Echo("*" * 53)
Echo("Real-Time Clipboard Syncing".center(53))
Echo(GITHUB_URL.center(53))
Echo("*" * 53)
def run(self):
try:
self.banner()
self.setup_logging()
self.ensure_single_instance()
self.config.load()
self.authenticate_and_connect()
self.config.save()
update_available = self.get_version_update_status()
donation_url = self.get_donation_url()
sys_tray = TaskbarPanel(
on_connect_callback=self._get_ws_manager().manual_reconnect,
on_disconnect_callback=self._get_ws_manager().disconnect,
on_logoff_callback=self.logoff_and_exit,
new_version_available=update_available,
github_url=GITHUB_URL,
donation_url=donation_url,
ws_interface=self._get_ws_manager(),
config=self.config,
)
self._get_ws_manager().set_tray_ref(sys_tray)
sys_tray.run()
except Exception as e:
msg = f"An unexpected error has occurred: {e}"
logging.error(msg)
CustomDialog(
msg + "\nCheck logs in project directory", msg_type="error"
).mainloop()
finally:
self._get_ws_manager().disconnect()
if PLATFORM == MACOS or PLATFORM.startswith(LINUX):
if self.lock_file is not None:
fcntl.flock(self.lock_file, fcntl.LOCK_UN)
self.lock_file.close()
os.remove(self.mutex_identifier)
-92
View File
@@ -1,92 +0,0 @@
import base64
import json
import os
import re
from core.constants import *
class Config:
def __init__(self, file_name=DATA_FILE_NAME):
self.file_name = file_name
self.data = {
"cipher_enabled": True,
"server_url": "http://localhost:8080",
"websocket_url": "",
"username": "",
"hashed_password": None,
"cookie": None,
"maxsize": None,
"hash_rounds": 664937,
"salt": "",
"csrf_token": "",
"notification": True,
"save_password": False,
"password": "",
"max_clipboard_size_local_limit_bytes": None,
"enable_image_sharing": True,
"enable_file_sharing": True,
"default_file_download_location": "",
"server_mode": "P2S",
"stun_url": "",
"ssl_ca_bundle": "",
}
def save(self):
"""
Save data to file
"""
try:
temp = self.data.copy()
if self.data.get("cipher_enabled") and self.data.get("hashed_password"):
temp["hashed_password"] = base64.b64encode(
temp["hashed_password"]
).decode("utf-8")
with open(self.file_name, "w") as f:
json.dump(temp, f, indent=4)
except Exception as e:
logging.error(f"Failed to save data: {e}")
def load(self):
"""
Load data from file
"""
if os.path.isfile(self.file_name):
try:
with open(self.file_name, "r") as f:
file_data = json.load(f)
self.data.update(file_data)
# Decode hashed_password if present
if self.data.get("hashed_password"):
self.data["hashed_password"] = base64.b64decode(
self.data["hashed_password"]
)
return True
except Exception as e:
logging.error(f"Failed to load data: {e}")
logging.error(
"Try deleting DATA file in the program directory, and re-run the program again"
)
return False
@staticmethod
def convert_to_websocket_url(input_url: str, endpoint: str = None) -> str:
if not input_url or not isinstance(input_url, str):
raise ValueError("Invalid URL provided")
# Trim whitespace, remove trailing slashes, and convert to lowercase
input_url = re.sub(r"/+$", "", input_url.strip()).lower()
# Determine protocol and convert
if input_url.startswith("https://"):
ws_url = input_url.replace("https://", "wss://", 1)
elif input_url.startswith("http://"):
ws_url = input_url.replace("http://", "ws://", 1)
else:
raise ValueError(f"Unsupported protocol in URL: {input_url}")
if endpoint is not None:
# Append the WebSocket endpoint and remove any trailing slash
ws_url += endpoint
ws_url = re.sub(r"/+$", "", ws_url)
return ws_url
-262
View File
@@ -1,262 +0,0 @@
import logging
import platform
import os
import sys
# platform constants
WINDOWS = "Windows"
MACOS = "macOS"
LINUX = "Linux"
LINUX_X11 = f"{LINUX}_X11"
LINUX_WAYLAND = f"{LINUX}_Wayland"
LINUX_HEADLESS = f"{LINUX}_Headless"
# OS detection
def get_os_and_display_server():
system = platform.system().lower().strip()
if system == "windows":
return WINDOWS
elif system == "darwin":
return MACOS
elif system == "linux":
session_type = os.environ.get("XDG_SESSION_TYPE", "").lower().strip()
if session_type == "wayland":
return LINUX_WAYLAND
elif session_type == "x11":
return LINUX_X11
else:
# Could be a headless session or another type of session
return LINUX_HEADLESS
else:
return "Unknown OS"
def detect_linux_display_server():
session_type = os.environ.get("XDG_SESSION_TYPE", "").lower().strip()
session_desktop = os.environ.get("XDG_SESSION_DESKTOP", "").lower().strip()
wayland_display = os.environ.get("WAYLAND_DISPLAY")
x_display = os.environ.get("DISPLAY")
# Priority detection order: X11 > XWayland > Hyprland > Wayland > Unknown
if session_type == "x11":
return "X11"
if session_type == "wayland" and x_display and wayland_display:
return "XWayland"
if session_type == "wayland" and session_desktop == "hyprland":
return "Hyprland"
if session_type == "wayland":
return "Wayland"
return "Unknown"
def _parse_linux_bool_flag_token(raw):
if raw is None or not str(raw).strip():
raise ValueError("empty value")
s = str(raw).strip().lower()
if s == "true":
return True
if s == "false":
return False
raise ValueError(raw)
def _parse_linux_positive_float(raw):
if raw is None or not str(raw).strip():
raise ValueError("empty value")
try:
value = float(str(raw).strip())
except ValueError:
raise ValueError(f"not a number: {raw!r}")
if value <= 0:
raise ValueError("must be a positive number")
return value
def _strip_linux_cli_overrides(argv):
"""
Linux-only: parse --gui / --xmode (true|false), --polling (seconds), remove them from argv.
Last occurrence wins if a flag is repeated.
"""
gui_override = None
xmode_override = None
polling_override = None
i = 1
kept = [argv[0]] if argv else []
while i < len(argv):
item = argv[i]
if item.startswith("--gui="):
gui_override = _parse_linux_bool_flag_token(item.split("=", 1)[1])
i += 1
continue
if item == "--gui":
if i + 1 >= len(argv):
raise ValueError("--gui requires true or false")
gui_override = _parse_linux_bool_flag_token(argv[i + 1])
i += 2
continue
if item.startswith("--xmode="):
xmode_override = _parse_linux_bool_flag_token(item.split("=", 1)[1])
i += 1
continue
if item == "--xmode":
if i + 1 >= len(argv):
raise ValueError("--xmode requires true or false")
xmode_override = _parse_linux_bool_flag_token(argv[i + 1])
i += 2
continue
if item.startswith("--polling="):
polling_override = _parse_linux_positive_float(item.split("=", 1)[1])
i += 1
continue
if item == "--polling":
if i + 1 >= len(argv):
raise ValueError("--polling requires a positive number (seconds)")
polling_override = _parse_linux_positive_float(argv[i + 1])
i += 2
continue
kept.append(item)
i += 1
argv[:] = kept
return gui_override, xmode_override, polling_override
PLATFORM = get_os_and_display_server()
# Linux: CLI UI vs GTK tray — False on other platforms (unused except behind LINUX checks).
LINUX_USE_CLI_UI = False
# Linux: optional override for xclip/wl-paste polling sleep (seconds); None = use built-ins (0.3 / 3).
LINUX_CLIPBOARD_POLL_INTERVAL_SEC = None
if PLATFORM.startswith(LINUX):
if (
detect_linux_display_server() == "X11"
or detect_linux_display_server() == "XWayland"
or detect_linux_display_server() == "Unknown"
):
XMODE = True
else:
XMODE = False
try:
gui_override, xmode_override, polling_override = _strip_linux_cli_overrides(
sys.argv
)
except ValueError as e:
print(f"clipcascade (Linux CLI): {e}", file=sys.stderr)
sys.exit(2)
if xmode_override is not None:
XMODE = xmode_override
if gui_override is not None:
LINUX_USE_CLI_UI = not gui_override
else:
LINUX_USE_CLI_UI = not XMODE
if polling_override is not None:
LINUX_CLIPBOARD_POLL_INTERVAL_SEC = polling_override
# App version
if PLATFORM == WINDOWS:
APP_VERSION = "3.2.0"
elif PLATFORM == MACOS:
APP_VERSION = "3.2.0"
elif PLATFORM.startswith(LINUX):
if XMODE:
APP_VERSION = "3.2.0" # gui version
else:
APP_VERSION = "3.2.0" # non-gui(cli) version
# core constants
RECONNECT_WS_TIMER = 10 # seconds
WEBSOCKET_TIMEOUT = 3000 # milliseconds
# P2P signaling WebSocket keepalive (RFC 6455 ping/pong).
P2P_WS_PING_INTERVAL_SEC = 25
P2P_WS_PING_TIMEOUT_SEC = 20
# Data-channel keepalive (JSON envelope with _cc_keepalive); helps idle sessions and mobile radios.
P2P_DC_HEARTBEAT_INTERVAL_SEC = 20
# After sleep, aiortc RTCPeerConnection.close() can block; cap wait so the asyncio
# thread does not stall (which would also block processing ASSIGNED_ID / PEER_LIST).
P2P_PC_CLOSE_TIMEOUT_SEC = 5.0
LOG_FILE_NAME = "clipcascade_log.log"
LOG_LEVEL = logging.INFO # Use valid levels: DEBUG, INFO, WARNING, ERROR, CRITICAL
DATA_FILE_NAME = "DATA"
MAX_SIZE = 1048576 # 1 MiB
FRAGMENT_SIZE = 15360 # 15 KiB
SUBSCRIPTION_DESTINATION = "/user/queue/cliptext"
SEND_DESTINATION = "/app/cliptext"
LOGIN_URL = "/login"
LOGOUT_URL = "/logout"
MAXSIZE_URL = "/max-size"
CSRF_URL = "/csrf-token"
SERVER_MODE_URL = "/server-mode"
WEBSOCKET_ENDPOINT = "/clipsocket"
WEBSOCKET_ENDPOINT_P2P = "/p2psignaling"
STUN_URL = "/stun-url"
VERSION_URL = "https://raw.githubusercontent.com/Sathvik-Rao/ClipCascade/main/version.json"
RELEASE_URL = "https://github.com/Sathvik-Rao/ClipCascade/releases/latest"
GITHUB_URL = "https://github.com/Sathvik-Rao/ClipCascade"
APP_NAME = "ClipCascade"
HELP_URL = f"{GITHUB_URL}/blob/main/README.md"
METADATA_URL = "https://raw.githubusercontent.com/Sathvik-Rao/ClipCascade/main/metadata.json"
if PLATFORM == WINDOWS:
MUTEX_NAME = "Global\\ClipCascade_Mutex_PSSR"
elif PLATFORM == MACOS or PLATFORM.startswith(LINUX):
MUTEX_NAME = "clipcascade.lock"
# helper functions
def get_user_home_directory():
"""
Get the user's home directory in a cross-platform manner.
On Windows, this resolves to something like C:\\Users\\<Username>
On macOS and Linux, this typically resolves to /Users/<Username> or /home/<Username>, respectively.
"""
return os.path.expanduser("~")
def get_program_files_directory():
"""
Get the directory containing the program files.
"""
if PLATFORM == MACOS:
app_dir = os.path.join(
get_user_home_directory(), "Library", "Application Support", "ClipCascade"
)
if not os.path.exists(app_dir):
try:
os.makedirs(app_dir)
except Exception as e:
raise e
return app_dir
else:
if getattr(sys, "frozen", False): # Running as a PyInstaller executable
return os.path.dirname(sys.executable)
else: # Running as a regular Python script
running_dir = os.path.dirname(os.path.abspath(__file__))
parent_dir = os.path.dirname(running_dir) # Go one folder up
return parent_dir
def get_downloads_folder():
"""
Get the path to the user's Downloads folder in a cross-platform manner.
By default, the Downloads directory is commonly located as:
- Windows: C:\\Users\\<Username>\\Downloads
- macOS: /Users/<Username>/Downloads
- Linux: /home/<Username>/Downloads
"""
return os.path.join(get_user_home_directory(), "Downloads")
-120
View File
@@ -1,120 +0,0 @@
import tkinter as tk
from tkinter import ttk
from tkinter import scrolledtext
import gc
import time
from utils.window_manager import center_window
from core.constants import *
class CustomDialog(tk.Tk):
def __init__(self, message, msg_type="info", timeout=None):
super().__init__()
self.message = message
self.msg_type = msg_type.lower()
self.timeout = timeout
self.after_id = None
self.style = ttk.Style(self)
self.style.configure("TFrame", background="#f2f2f2")
self.style.configure(
"TLabel", background="#f2f2f2", foreground="#333333", font=("Arial", 11)
)
self.style.configure("Header.TLabel", font=("Arial", 14, "bold"))
self.style.configure("TButton", font=("Arial", 11))
self._configure_window()
self._show_dialog()
if self.timeout:
self.after_id = self.after(self.timeout, self.close)
# Allow closing with keyboard shortcuts
self.bind("<Return>", lambda e: self.close())
self.bind("<Escape>", lambda e: self.close())
def _configure_window(self):
"""Configure the dialog window properties."""
self.title("ClipCascade")
self.geometry(
"600x300+{}+{}".format(
(self.winfo_screenwidth() - 600) // 2,
(self.winfo_screenheight() - 300) // 2,
)
)
self.update_idletasks()
center_window(self)
self.attributes("-topmost", True)
self.resizable(False, False)
self.focus_force()
if PLATFORM == MACOS:
self.after(100, self._macos_restore_focus)
def _show_dialog(self):
"""Display the appropriate dialog based on the message type."""
type_config = {
"success": ("Success", "green", "✔"),
"error": ("Error", "red", "✖"),
"warning": ("Warning", "orange", "⚠"),
"info": ("Information", "blue", "ℹ"),
}
title, color, symbol = type_config.get(self.msg_type, ("Message", "black", "•"))
# Create a main frame
main_frame = ttk.Frame(self, padding="20 20 20 20")
main_frame.pack(fill="both", expand=True)
# Title frame with symbol and title
title_frame = ttk.Frame(main_frame)
title_frame.pack(pady=(0, 10), fill="x")
symbol_label = ttk.Label(
title_frame, text=symbol, font=("Arial", 18, "bold"), foreground=color
)
symbol_label.pack(side="left", padx=(0, 10))
title_label = ttk.Label(title_frame, text=title, style="Header.TLabel", foreground=color)
title_label.pack(side="left")
# Message frame for scrolled text
message_frame = ttk.Frame(main_frame)
message_frame.pack(fill="both", expand=True, pady=10)
# ScrolledText widget for the message
self.text_widget = scrolledtext.ScrolledText(
message_frame, wrap="word", font=("Arial", 11), width=70, height=8
)
self.text_widget.pack(fill="both", expand=True)
# Insert the message and disable editing
self.text_widget.insert("1.0", self.message)
self.text_widget.config(state="disabled")
# Button frame
button_frame = ttk.Frame(main_frame)
button_frame.pack(pady=(10, 0))
ok_button = ttk.Button(button_frame, text="OK", command=self.close, width=10)
ok_button.pack()
ok_button.focus_set()
def _macos_restore_focus(self):
"""Force macOS to properly activate and focus the dialog."""
try:
from AppKit import NSApplication
app = NSApplication.sharedApplication()
app.activateIgnoringOtherApps_(True)
except ImportError:
pass
self.lift()
self.focus_force()
def close(self):
if self.after_id:
self.after_cancel(self.after_id) # Cancel the after event if it exists
self.after_id = None
self.destroy()
gc.collect()
time.sleep(0.5)
-648
View File
@@ -1,648 +0,0 @@
import re
import tkinter as tk
from tkinter import ttk, font
import gc
import time
import os
from utils.window_manager import center_window
from core.config import Config
from gui.info import CustomDialog
from core.constants import *
class HoverTooltip:
"""Simple hover tooltip for Tk widgets."""
def __init__(self, widget, text, wraplength=520):
self.widget = widget
self.text = text
self.wraplength = wraplength
self.tooltip_window = None
self.widget.bind("<Enter>", self._show, add="+")
self.widget.bind("<Leave>", self._hide, add="+")
self.widget.bind("<ButtonPress>", self._hide, add="+")
def _show(self, _event=None):
if self.tooltip_window or not self.text.strip():
return
# Position tooltip near the widget with an offset.
x = self.widget.winfo_rootx() + 18
y = self.widget.winfo_rooty() + self.widget.winfo_height() + 8
self.tooltip_window = tw = tk.Toplevel(self.widget)
tw.wm_overrideredirect(True)
tw.wm_geometry(f"+{x}+{y}")
label = tk.Label(
tw,
text=self.text,
justify=tk.LEFT,
relief=tk.SOLID,
borderwidth=1,
background="#ffffe0",
foreground="#202020",
font=("Helvetica", 10),
wraplength=self.wraplength,
padx=8,
pady=6,
)
label.pack()
def _hide(self, _event=None):
if self.tooltip_window:
self.tooltip_window.destroy()
self.tooltip_window = None
class LoginForm(tk.Tk):
def __init__(
self,
config: Config,
on_login_callback=None,
on_quit_callback=None,
):
super().__init__()
self.config = config
self.on_login_callback = on_login_callback
self.on_quit_callback = on_quit_callback
if PLATFORM == MACOS or PLATFORM.startswith(LINUX):
# Set an initial size to avoid 0 size issue
# self.geometry("800x450")
self.update_idletasks()
self.withdraw() # Hide the root window
self.title("ClipCascade")
self._tooltips = []
# Make the window appear on top and grab focus
self.attributes("-topmost", True)
self.focus_force()
# Configure styles
style = ttk.Style(self)
# Use default theme (may vary by OS); consider 'clam', 'alt', or 'default'
style.configure("TLabel", font=("Helvetica", 13), padding=5)
style.configure("TEntry", font=("Helvetica", 13), padding=5)
style.configure("TButton", font=("Helvetica", 13), padding=5)
style.configure("TCheckbutton", font=("Helvetica", 13), padding=5)
# Main frame with padding
main_frame = ttk.Frame(self, padding=20)
main_frame.pack(fill=tk.BOTH, expand=True)
# Title Label
title_label = ttk.Label(
main_frame,
text="Please Log In",
font=("Helvetica", 16, "bold"),
takefocus=False,
)
title_label.pack(pady=(0, 10))
# Create a frame for the fields
self.field_frame = ttk.Frame(main_frame)
self.field_frame.pack(padx=10, pady=10, fill=tk.X)
# Username
user_label = ttk.Label(self.field_frame, text="Username:")
user_label.grid(row=0, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.username_entry = ttk.Entry(self.field_frame, width=50, font=("Helvetica", 13))
self.username_entry.insert(0, self.config.data["username"])
self.username_entry.grid(row=0, column=1, padx=10, pady=5, sticky=tk.W + tk.E)
self._add_tooltip(
[user_label, self.username_entry],
"Username used to log in to your ClipCascade account.\n\n"
"Use the same account name on all devices that should share clipboard data.",
)
# Password
pass_label = ttk.Label(self.field_frame, text="Password:")
pass_label.grid(row=1, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.password_frame = ttk.Frame(self.field_frame)
self.password_frame.grid(row=1, column=1, padx=10, pady=5, sticky=tk.W + tk.E)
self.password_entry = ttk.Entry(
self.password_frame, show="*", width=47, font=("Helvetica", 13)
)
self.password_entry.insert(0, self.config.data["password"])
self.password_entry.pack(side=tk.LEFT, fill=tk.X, expand=True)
self.eye_icon = ttk.Label(
self.password_frame, text="🙈", cursor="hand2", takefocus=False
)
self.eye_icon.pack(side=tk.RIGHT, padx=(5, 0))
self.eye_icon.bind("<Button-1>", self._toggle_password)
self._add_tooltip(
[pass_label, self.password_entry, self.eye_icon],
"Account password used for server authentication.\n\n"
"If encryption is enabled, this password is also used to derive your encryption key.\n"
"Use the same password on all devices for successful decrypt/sync.",
)
# Server URL
server_label = ttk.Label(self.field_frame, text="Server URL:")
server_label.grid(row=2, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.server_url_entry = ttk.Entry(self.field_frame, width=50, font=("Helvetica", 13))
self.server_url_entry.insert(0, self.config.data["server_url"])
self.server_url_entry.grid(row=2, column=1, padx=10, pady=5, sticky=tk.W + tk.E)
self._add_tooltip(
[server_label, self.server_url_entry],
"Address of your ClipCascade server.\n\n"
"Examples:\n"
"- Local server: http://localhost:8080\n"
"- LAN server: http://192.168.1.50:8080\n"
"- Reverse proxy/domain: https://clipcascade.example.com\n\n"
"Include protocol (http/https). Do not add /login or /clipsocket.",
)
# Configure grid weights to ensure entries expand
self.field_frame.columnconfigure(1, weight=1)
# Checkboxes frame
checks_frame = ttk.Frame(main_frame)
checks_frame.pack(pady=(5, 10), fill=tk.X)
# Encryption Checkbox
self.cipher_var = tk.BooleanVar(value=self.config.data["cipher_enabled"])
self.cipher_checkbox = ttk.Checkbutton(
checks_frame,
text="Enable Encryption (recommended)",
variable=self.cipher_var,
takefocus=False,
)
self.cipher_checkbox.pack(pady=3, anchor=tk.W)
self._add_tooltip(
[self.cipher_checkbox],
"Enables end-to-end encryption for clipboard content (recommended).\n\n"
"When enabled, clipboard data is encrypted on-device before sending.\n"
"All devices in the same account must use the same encryption settings "
"(password, salt, and hash rounds) to decrypt data correctly.",
)
# Notification Checkbox
self.notification_var = tk.BooleanVar(value=self.config.data["notification"])
self.notification_checkbox = ttk.Checkbutton(
checks_frame,
text="Enable Notification",
variable=self.notification_var,
takefocus=False,
)
self.notification_checkbox.pack(pady=3, anchor=tk.W)
self._add_tooltip(
[self.notification_checkbox],
"Shows local notifications for connection status events.\n\n"
"Useful to know when WebSocket disconnects/reconnects happen.\n"
"Turn this off if you prefer a quieter experience with fewer popups.",
)
# Button frame
button_frame = ttk.Frame(main_frame)
button_frame.pack(pady=(10, 0))
# Login Button
self.login_button = ttk.Button(button_frame, text="Login", command=self.on_login)
self.login_button.pack()
# Extra Configurations Toggle Label
# macOS: show advanced fields by default
self.show_extra = PLATFORM == MACOS
self.toggle_normal_color = "#007acc" # neutral blue with strong contrast
self.toggle_hover_color = "#005a9e" # slightly darker for hover feedback
self.toggle_label = tk.Label(
main_frame,
text="Hide Extra Config" if PLATFORM == MACOS else "Enable Extra Config",
fg=self.toggle_normal_color,
cursor="hand2",
font=font.Font(family="Helvetica", size=13, underline=True),
takefocus=False,
)
self.toggle_label.pack(pady=(5, 10))
self.toggle_label.bind("<Button-1>", self._toggle_extra_config)
self._add_tooltip(
[self.toggle_label],
"Shows advanced settings for encryption and clipboard behavior.\n\n"
"Most users can keep defaults. Open this section only if you need custom tuning.",
)
# hover effects for the toggle label
self.toggle_label.bind("<Enter>", self._on_hover)
self.toggle_label.bind("<Leave>", self._on_leave)
# Extra Configuration Frame with Scrollbar
self.extra_frame_container = ttk.Frame(main_frame)
if PLATFORM == MACOS:
self.extra_frame_container.pack(fill=tk.BOTH, expand=True)
else:
self.extra_frame_container.pack_forget()
# Create a canvas inside the extra_frame_container
self.extra_canvas = tk.Canvas(
self.extra_frame_container,
borderwidth=0,
background="#f0f0f0",
takefocus=False,
)
self.extra_canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
# Add a vertical scrollbar to the canvas
self.scrollbar = ttk.Scrollbar(
self.extra_frame_container,
orient="vertical",
command=self.extra_canvas.yview,
takefocus=False,
)
self.scrollbar.pack(side=tk.RIGHT, fill=tk.Y)
# Configure the canvas to use the scrollbar
self.extra_canvas.configure(yscrollcommand=self.scrollbar.set)
# Create a frame inside the canvas to hold the extra configuration widgets
self.extra_frame = ttk.Frame(self.extra_canvas, padding=10)
self.extra_frame_window = self.extra_canvas.create_window(
(0, 0), window=self.extra_frame, anchor="nw"
)
# Bind the configure event to update the scrollregion
self.extra_frame.bind(
"<Configure>",
lambda event: self.extra_canvas.configure(scrollregion=self.extra_canvas.bbox("all")),
)
# Bind a configure event to the container to adjust the width
self.extra_frame_container.bind("<Configure>", self._on_extra_container_configure)
# Hash Rounds
hash_rounds_label = ttk.Label(self.extra_frame, text="Hash Rounds:")
hash_rounds_label.grid(row=0, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.hash_rounds_entry = ttk.Entry(self.extra_frame, width=50, font=("Helvetica", 13))
self.hash_rounds_entry.insert(0, str(self.config.data["hash_rounds"]))
self.hash_rounds_entry.grid(row=0, column=1, padx=10, pady=5, sticky=tk.W + tk.E)
self._add_tooltip(
[hash_rounds_label, self.hash_rounds_entry],
"Number of hash iterations used for encryption key derivation.\n\n"
"Higher value = stronger brute-force resistance, but slower processing.\n"
"Default is tuned for balance. Keep default unless you know why to change.\n"
"Must be a positive integer and must match on every device.",
)
# Salt
salt_label = ttk.Label(self.extra_frame, text="Salt:")
salt_label.grid(row=1, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.salt_entry = ttk.Entry(self.extra_frame, width=50, font=("Helvetica", 13))
self.salt_entry.insert(0, self.config.data["salt"])
self.salt_entry.grid(row=1, column=1, padx=10, pady=5, sticky=tk.W + tk.E)
self._add_tooltip(
[salt_label, self.salt_entry],
"Optional extra text mixed into encryption key generation.\n\n"
"It can be any combination of letters and numbers (you can also include symbols/spaces if desired).\n"
"Use the same exact salt on all devices if encryption is enabled.\n"
"If left blank, encryption still works using password + hash rounds.\n"
"Changing salt later will prevent old devices from decrypting new clipboard data.",
)
# Save Password Locally Checkbox
save_password_label = ttk.Label(
self.extra_frame,
text="Store Password Locally\n(not recommended; \nonly works if encryption is disabled):",
)
save_password_label.grid(row=2, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.save_password_var = tk.BooleanVar(value=self.config.data["save_password"])
self.save_password_checkbox = ttk.Checkbutton(
self.extra_frame,
variable=self.save_password_var,
takefocus=False,
)
self.save_password_checkbox.grid(row=2, column=1, padx=10, pady=5, sticky=tk.W)
self._add_tooltip(
[save_password_label, self.save_password_checkbox],
"Stores your plain password locally for automatic login convenience.\n\n"
"Security trade-off: avoid this on shared or untrusted machines.\n"
"This only works when encryption is disabled.",
)
# Maximum Clipboard Size - Local Limit
local_clipboard_size_label = ttk.Label(
self.extra_frame, text="Maximum Clipboard Size\nLocal Limit (in bytes):"
)
local_clipboard_size_label.grid(row=3, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.local_clipboard_size_entry = ttk.Entry(
self.extra_frame, width=50, font=("Helvetica", 13)
)
self.local_clipboard_size_entry.insert(
0, str(self.config.data["max_clipboard_size_local_limit_bytes"] or "")
)
self.local_clipboard_size_entry.grid(row=3, column=1, padx=10, pady=5, sticky=tk.W + tk.E)
self._add_tooltip(
[local_clipboard_size_label, self.local_clipboard_size_entry],
"Optional local safety limit for clipboard payload size (incoming and outgoing) in bytes.\n\n"
"Example: 1 MiB = 1048576 bytes.\n"
"Leave empty for no local limit.\n"
"Use a lower value if your device struggles with very large clipboard data "
"(large text/images/files). Must be a positive integer.",
)
# Enable Image Sharing Checkbox
enable_image_sharing_label = ttk.Label(self.extra_frame, text="Enable Image Sharing:")
enable_image_sharing_label.grid(row=4, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.enable_image_sharing_var = tk.BooleanVar(
value=self.config.data["enable_image_sharing"]
)
self.enable_image_sharing_checkbox = ttk.Checkbutton(
self.extra_frame,
variable=self.enable_image_sharing_var,
takefocus=False,
)
self.enable_image_sharing_checkbox.grid(row=4, column=1, padx=10, pady=5, sticky=tk.W)
self._add_tooltip(
[enable_image_sharing_label, self.enable_image_sharing_checkbox],
"Controls whether this device sends copied images to other devices.\n\n"
"If disabled, this device can still receive images sent from other devices.",
)
# Enable File Sharing Checkbox
enable_file_sharing_label = ttk.Label(self.extra_frame, text="Enable File Sharing:")
enable_file_sharing_label.grid(row=5, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.enable_file_sharing_var = tk.BooleanVar(value=self.config.data["enable_file_sharing"])
self.enable_file_sharing_checkbox = ttk.Checkbutton(
self.extra_frame,
variable=self.enable_file_sharing_var,
takefocus=False,
)
self.enable_file_sharing_checkbox.grid(row=5, column=1, padx=10, pady=5, sticky=tk.W)
self._add_tooltip(
[enable_file_sharing_label, self.enable_file_sharing_checkbox],
"Controls whether this device sends copied/shared files to other devices.\n\n"
"If disabled, this device can still receive files sent from other devices.",
)
# Default File Download Location
default_file_download_location_label = ttk.Label(
self.extra_frame, text="Default File Download Location:"
)
default_file_download_location_label.grid(
row=6, column=0, padx=(0, 10), pady=5, sticky=tk.W
)
self.default_file_download_location_entry = ttk.Entry(
self.extra_frame, width=50, font=("Helvetica", 13)
)
self.default_file_download_location_entry.insert(
0, self.config.data["default_file_download_location"]
)
self.default_file_download_location_entry.grid(
row=6, column=1, padx=10, pady=5, sticky=tk.W + tk.E
)
self._add_tooltip(
[default_file_download_location_label, self.default_file_download_location_entry],
"Optional default folder to save incoming files automatically.\n\n"
"Examples:\n"
"- Windows: C:\\Users\\YourName\\Downloads\n"
"- macOS/Linux: /Users/yourname/Downloads\n\n"
"Leave blank to choose a location manually when downloading files.\n"
"Path must already exist on this device.",
)
# SSL CA bundle (private / corporate PKI)
ssl_ca_label = ttk.Label(self.extra_frame, text="SSL CA bundle (optional):")
ssl_ca_label.grid(row=7, column=0, padx=(0, 10), pady=5, sticky=tk.W)
self.ssl_ca_bundle_entry = ttk.Entry(
self.extra_frame, width=50, font=("Helvetica", 13)
)
self.ssl_ca_bundle_entry.insert(
0, self.config.data.get("ssl_ca_bundle") or ""
)
self.ssl_ca_bundle_entry.grid(row=7, column=1, padx=10, pady=5, sticky=tk.W + tk.E)
self._add_tooltip(
[ssl_ca_label, self.ssl_ca_bundle_entry],
"Path to a PEM file that contains your root CA (or full chain) for HTTPS/WSS.\n\n"
"Leave empty for default verification (public CAs / OS defaults).\n"
"Use this when your server uses a certificate from a private or internal CA.\n\n"
"Example: /etc/ssl/corp-root.pem or C:\\\\certs\\\\corp-root.pem",
)
# Configure grid weights for extra_frame
self.extra_frame.columnconfigure(1, weight=1)
# Bind mouse wheel events for scrolling
self._bind_mousewheel()
# Handle window close
self.protocol("WM_DELETE_WINDOW", self.on_quit)
# Update idle tasks to calculate widget sizes
self.update_idletasks()
# Set a maximum height for the window
self.max_window_height = 600
# on press enter key
self.bind("<Return>", lambda event: self.on_login())
self._sync_login_tab_order()
self.deiconify() # Show window
self.update_idletasks()
center_window(self, self.max_window_height)
# Drop always-on-top after showing
self.after(300, lambda: self.attributes("-topmost", False))
if PLATFORM == MACOS:
self.after(400, self._macos_restore_focus)
def _sync_login_tab_order(self):
"""Tab cycles username → password → server → Login → [extra entries if shown] → repeat.
Checkboxes and chrome are excluded from keyboard focus."""
extra_entries = (
self.hash_rounds_entry,
self.salt_entry,
self.local_clipboard_size_entry,
self.default_file_download_location_entry,
self.ssl_ca_bundle_entry,
)
for w in extra_entries:
w.configure(takefocus=bool(self.show_extra))
def _add_tooltip(self, widgets, text):
for widget in widgets:
self._tooltips.append(HoverTooltip(widget, text))
def _macos_restore_focus(self):
"""Force macOS to properly activate and focus the window.
Needed after sequential tk.Tk() creation/destruction cycles."""
try:
from AppKit import NSApplication
app = NSApplication.sharedApplication()
app.activateIgnoringOtherApps_(True)
except ImportError:
pass
self.lift()
self.focus_force()
self.username_entry.focus_set()
def _toggle_password(self, event=None):
if self.password_entry.cget("show") == "*":
self.password_entry.config(show="")
self.eye_icon.config(text="🐵")
else:
self.password_entry.config(show="*")
self.eye_icon.config(text="🙈")
def _toggle_extra_config(self, event=None):
"""Toggle the visibility of the extra configuration fields."""
extra_entries = (
self.hash_rounds_entry,
self.salt_entry,
self.local_clipboard_size_entry,
self.default_file_download_location_entry,
self.ssl_ca_bundle_entry,
)
if self.show_extra:
focused = self.focus_get()
if focused in extra_entries:
self.login_button.focus_set()
self.extra_frame_container.pack_forget()
self.toggle_label.config(text="Enable Extra Config")
else:
self.extra_frame_container.pack(fill=tk.BOTH, expand=True)
self.toggle_label.config(text="Hide Extra Config")
self.show_extra = not self.show_extra
self._sync_login_tab_order()
self.update_idletasks()
self.geometry("")
self.update_idletasks()
center_window(self)
def _on_hover(self, event=None):
"""Change text color on hover."""
self.toggle_label.config(fg=self.toggle_hover_color)
def _on_leave(self, event=None):
"""Revert text color when not hovered."""
self.toggle_label.config(fg=self.toggle_normal_color)
def _bind_mousewheel(self):
"""Bind mouse wheel events to the canvas for scrolling."""
if PLATFORM == WINDOWS:
self.extra_canvas.bind_all("<MouseWheel>", self._on_mousewheel_windows)
elif PLATFORM == MACOS:
self.extra_canvas.bind_all("<MouseWheel>", self._on_mousewheel_mac)
elif PLATFORM.startswith(LINUX):
# Linux uses Button-4 and Button-5 for scroll up/down
self.extra_canvas.bind_all("<Button-4>", self._on_mousewheel_linux)
self.extra_canvas.bind_all("<Button-5>", self._on_mousewheel_linux)
def _on_mousewheel_windows(self, event):
"""Handle mouse wheel scrolling on Windows."""
self.extra_canvas.yview_scroll(int(-1 * (event.delta / 120)), "units")
def _on_mousewheel_mac(self, event):
"""Handle mouse wheel scrolling on macOS."""
self.extra_canvas.yview_scroll(int(-1 * event.delta), "units")
def _on_mousewheel_linux(self, event):
"""Handle mouse wheel scrolling on Linux."""
if event.num == 4:
self.extra_canvas.yview_scroll(-1, "units")
elif event.num == 5:
self.extra_canvas.yview_scroll(1, "units")
def _on_extra_container_configure(self, event):
"""Adjust the width of the extra_frame as the container is resized."""
canvas_width = event.width - self.scrollbar.winfo_width()
self.extra_canvas.itemconfigure(self.extra_frame_window, width=canvas_width)
@staticmethod
def remove_trailing_slash(entry):
return re.sub(r"/+$", "", entry)
@staticmethod
def is_positive_integer(value):
if value.isdigit() and int(value) > 0:
return True
else:
return False
def on_login(self):
# save data to config
self.config.data["username"] = self.username_entry.get()
self.config.data["password"] = self.password_entry.get()
self.config.data["server_url"] = LoginForm.remove_trailing_slash(
self.server_url_entry.get().strip()
)
self.config.data["cipher_enabled"] = self.cipher_var.get()
self.config.data["notification"] = self.notification_var.get()
# extra fields
# Validate hash_rounds
hash_rounds_input = self.hash_rounds_entry.get().strip()
if not LoginForm.is_positive_integer(hash_rounds_input):
CustomDialog(
"Invalid Input\nHash Rounds must be a positive integer.",
msg_type="error",
).mainloop()
return # retry login
self.config.data["hash_rounds"] = int(hash_rounds_input)
self.config.data["salt"] = self.salt_entry.get()
self.config.data["save_password"] = self.save_password_var.get()
# Validate max_clipboard_size_local_limit_bytes
max_clipboard_size_local_limit_bytes_input = self.local_clipboard_size_entry.get().strip()
if max_clipboard_size_local_limit_bytes_input == "":
self.config.data["max_clipboard_size_local_limit_bytes"] = None
else:
if not LoginForm.is_positive_integer(max_clipboard_size_local_limit_bytes_input):
CustomDialog(
"Invalid Input\nMax Clipboard Size Local Limit must be a positive integer.",
msg_type="error",
).mainloop()
return # retry login
self.config.data["max_clipboard_size_local_limit_bytes"] = int(
max_clipboard_size_local_limit_bytes_input
)
self.config.data["enable_image_sharing"] = self.enable_image_sharing_var.get()
self.config.data["enable_file_sharing"] = self.enable_file_sharing_var.get()
# Validate file download location
default_file_download_location = self.default_file_download_location_entry.get().strip()
if default_file_download_location == "":
self.config.data["default_file_download_location"] = ""
else:
if not os.path.exists(default_file_download_location):
CustomDialog(
"Invalid Input\nDefault File Download Location does not exist.",
msg_type="error",
).mainloop()
return # retry login
self.config.data["default_file_download_location"] = default_file_download_location
ssl_ca_bundle = self.ssl_ca_bundle_entry.get().strip()
if ssl_ca_bundle:
if not os.path.isfile(ssl_ca_bundle):
CustomDialog(
"Invalid Input\nSSL CA bundle path is not a file or does not exist.",
msg_type="error",
).mainloop()
return
self.config.data["ssl_ca_bundle"] = ssl_ca_bundle
# call login callback
if self.on_login_callback:
self.on_login_callback()
self.close()
def on_quit(self):
if self.on_quit_callback:
self.on_quit_callback()
self.close()
def close(self):
self.destroy()
gc.collect()
time.sleep(0.5)
-6
View File
@@ -1,6 +0,0 @@
from tkinter import messagebox
class MessageBox:
def askquestion(self, title, message):
return messagebox.askquestion(title, message)
-397
View File
@@ -1,397 +0,0 @@
import math
import os
import threading
import time
import tkinter as tk
from tkinter import filedialog
import webbrowser
from pystray import Icon, MenuItem as item, Menu
from PIL import Image, ImageDraw
from core.config import Config
from gui.info import CustomDialog
from core.constants import *
if PLATFORM != WINDOWS:
import subprocess
class TaskbarPanel:
def __init__(
self,
on_connect_callback: callable = None,
on_disconnect_callback: callable = None,
on_logoff_callback: callable = None,
new_version_available: list = None,
github_url: str = GITHUB_URL,
donation_url: str = None,
ws_interface=None, # type= interfaces.ws_interface.WSInterface
config: Config = None,
):
self.on_connect_callback = on_connect_callback
self.on_disconnect_callback = on_disconnect_callback
self.on_logoff_callback = on_logoff_callback
self.new_version_available = new_version_available
self.github_url = github_url
self.donation_url = donation_url
self.ws_interface = ws_interface
self.config = config
self.is_disconnecting = False
self.disconnecting_items = None
self.is_file_download_enabled = False
self.file_download_items = None
self.previous_stats: str = ""
self.previous_stats_items = None
self.root = tk.Tk()
self.root.withdraw() # Hide the root window
# Hide dock icon on macOS after creating tkinter window
if PLATFORM == MACOS:
try:
from AppKit import NSApplication, NSApplicationActivationPolicyAccessory
NSApplication.sharedApplication().setActivationPolicy_(NSApplicationActivationPolicyAccessory)
except ImportError:
pass
# Initial state: Connected
self.is_connected = True
# Create the tray icon
self.icon = Icon(
"ClipCascade", self.create_clipboard_icon(), menu=self.create_menu()
)
self.icon.title = "ClipCascade"
self.update_stats() # Start the stats update thread
def run(self):
self.icon.run()
def _create_clipboard_base_image(self):
"""Shared clipboard artwork for normal tray icon and file-download badge variant."""
width, height = 64, 64
image = Image.new("RGBA", (width, height), (0, 0, 0, 0))
draw = ImageDraw.Draw(image)
fill_color = (220, 220, 220)
outline_color = (255, 255, 255)
board_coords = (12, 12, 52, 57)
try:
draw.rounded_rectangle(
board_coords, radius=5, fill=None, outline=outline_color, width=3
)
except (AttributeError, TypeError):
draw.rectangle(board_coords, fill=None, outline=outline_color)
clip_coords = (22, 7, 42, 17)
try:
draw.rounded_rectangle(
clip_coords, radius=3, fill=fill_color, outline=outline_color, width=3
)
except (AttributeError, TypeError):
draw.rectangle(clip_coords, fill=fill_color, outline=outline_color)
return image
def create_clipboard_icon(self):
return self._create_clipboard_base_image()
def create_clipboard_icon_with_dot(self):
"""Same clipboard as normal state, plus a blue notification dot for pending file download."""
image = self._create_clipboard_base_image().copy()
draw = ImageDraw.Draw(image)
width, height = 64, 64
dot_radius = 8
dot_center_x = width - dot_radius - 5
dot_center_y = dot_radius + 5
dot_bbox = [
dot_center_x - dot_radius,
dot_center_y - dot_radius,
dot_center_x + dot_radius,
dot_center_y + dot_radius,
]
draw.ellipse(dot_bbox, fill=(0, 128, 255, 255))
highlight_radius = dot_radius // 2
highlight_center_x = dot_center_x - highlight_radius // 2
highlight_center_y = dot_center_y - highlight_radius // 2
highlight_bbox = [
highlight_center_x - highlight_radius,
highlight_center_y - highlight_radius,
highlight_center_x + highlight_radius,
highlight_center_y + highlight_radius,
]
draw.ellipse(highlight_bbox, fill=(255, 255, 255, 180))
return image
def create_menu(self, item_: tuple = None):
"""Create the menu for the tray icon.
Args:
item_ (tuple, optional): The item that triggered the menu. Defaults to None.
item_ = (text, location, callback)
Returns:
Menu: The menu for the tray icon.
"""
# Menu items
menu_items = [
Menu.SEPARATOR,
item("🗒️ Open Logs", self._open_logs),
item("📂 Program Files", self._open_program_location),
Menu.SEPARATOR,
item("🏠 Homepage", self._open_homepage),
item("❓ Help", self._open_help),
item("💟 Donate", self._open_donate),
item("🌐 GitHub", self._open_github),
Menu.SEPARATOR,
item("🔒 Logoff and Quit", self._on_logoff),
item("❌ Quit", self._on_quit),
]
# Add connect/disconnect option (top of the menu - 0 index)
if not self.is_connected:
menu_items.insert(0, item("🔗 Connect", self._on_connect, default=True))
else:
if self.is_disconnecting and self.disconnecting_items is not None:
menu_items.insert(
self.disconnecting_items[1],
item(self.disconnecting_items[0], self.disconnecting_items[2]),
)
else:
menu_items.insert(0, item("⛓️‍💥 Disconnect", self._on_disconnect))
# Add update option (before the last 3 items)
if self.new_version_available is not None and self.new_version_available[0]:
menu_items.insert(
len(menu_items) - 3,
item(
f"🔄 Update ({self.new_version_available[2]} ➞ {self.new_version_available[1]})",
self._on_update,
),
)
# Add files download option (top of the menu - 0 index)
if self.is_file_download_enabled and self.file_download_items is not None:
menu_items.insert(
self.file_download_items[1],
item(
self.file_download_items[0],
self.file_download_items[2],
default=True,
),
)
# Add stats option (top of the menu - 0 index)
if self.previous_stats_items is not None:
menu_items.insert(
self.previous_stats_items[1],
item(
self.previous_stats_items[0],
self.previous_stats_items[2],
enabled=self.previous_stats_items[2] is not None,
),
)
return Menu(*menu_items)
def update_menu(self, item_: tuple = None):
self.icon.menu = self.create_menu(item_=item_)
def update_stats(self):
threading.Thread(target=self._update_stats_thread, daemon=True).start()
def _update_stats_thread(self):
while True:
current_stats = self.ws_interface.get_stats()
if current_stats is not None and self.previous_stats != current_stats:
self.previous_stats = current_stats
self.previous_stats_items = (current_stats, 0, None)
self.update_menu()
time.sleep(1) # Sleep for 1 second
@staticmethod
def open_webbrowser(url):
try:
webbrowser.open(url)
except Exception as e:
CustomDialog(
f"Failed to open the browser. Here is the URL: {url}\nError: {e}",
msg_type="error",
).mainloop()
def _on_update(self, icon, item):
TaskbarPanel.open_webbrowser(self.new_version_available[3])
def _on_connect(self, icon, item):
if self.on_connect_callback:
try:
self.on_connect_callback()
except Exception as e:
pass
self.is_connected = True
self.update_menu()
def _on_disconnect(self, icon, item):
if self.on_disconnect_callback:
self.on_disconnect_callback()
if self.ws_interface is not None and self.ws_interface.is_auto_reconnecting:
threading.Thread(
target=self._wait_to_disconnect, args=(icon, item), daemon=True
).start()
else:
self.is_connected = False
self.update_menu()
def _wait_to_disconnect(self, icon, item):
"""
Wait for the auto-reconnect timer to expire before disconnecting.
"""
if self.ws_interface is None:
return
timeout = math.ceil(self.ws_interface.get_total_timeout() / 1000)
while timeout > 0:
self.is_disconnecting = True
self.disconnecting_items = (
f"⏳ Disconnecting... ({timeout} sec)",
0,
None,
) # text, location, callback
self.update_menu()
time.sleep(1) # seconds
timeout -= 1
self.is_disconnecting = False
self.disconnecting_items = None
self.ws_interface.is_auto_reconnecting = False
self.is_connected = False
self.update_menu()
def _open_homepage(self, icon, item):
TaskbarPanel.open_webbrowser(self.config.data["server_url"])
def _open_github(self, icon, item):
TaskbarPanel.open_webbrowser(self.github_url)
def _open_help(self, icon, item):
TaskbarPanel.open_webbrowser(HELP_URL)
def _open_donate(self, icon, item):
if self.donation_url is not None:
TaskbarPanel.open_webbrowser(self.donation_url)
def open_location(self, path):
if PLATFORM == WINDOWS:
os.startfile(path)
elif PLATFORM == MACOS:
subprocess.run(["open", path])
elif PLATFORM.startswith(LINUX):
subprocess.run(["xdg-open", path])
def _open_logs(self, icon, item):
log_file_path = os.path.join(get_program_files_directory(), LOG_FILE_NAME)
if os.path.exists(log_file_path):
try:
self.open_location(log_file_path)
except Exception as e:
CustomDialog(
f"Failed to open the log file '{log_file_path}'.\nError: {e}",
msg_type="error",
).mainloop()
else:
CustomDialog(
f"Log file not found at '{log_file_path}'.", msg_type="error"
).mainloop()
def _open_program_location(self, icon, item):
try:
program_location = get_program_files_directory()
self.open_location(program_location)
except Exception as e:
CustomDialog(
f"Failed to open the program location '{program_location}'.\nError: {e}",
msg_type="error",
).mainloop()
def enable_files_download(self, files):
self.is_file_download_enabled = True
self.icon.icon = self.create_clipboard_icon_with_dot()
self.file_download_items = (
"📥 Download File(s)",
0,
lambda icon, item: self._on_download(icon, item, files),
)
self.update_menu()
def disable_files_download(self):
self.is_file_download_enabled = False
self.file_download_items = None
self.icon.icon = self.create_clipboard_icon()
self.update_menu()
def _on_download(self, icon, item, files):
"""Download the files to the user's Downloads folder."""
try:
try:
if self.config.data["default_file_download_location"] != "":
target_directory = self.config.data[
"default_file_download_location"
]
else:
target_directory = filedialog.askdirectory(
title="Select location to Save File(s)",
initialdir=get_downloads_folder(),
)
if not target_directory:
logging.debug("No directory selected. Exiting.")
return
except RuntimeError as re:
target_directory = os.path.join(
get_program_files_directory(), "downloads"
)
if not os.path.exists(target_directory):
os.makedirs(target_directory)
logging.error(
f"A runtime error occurred while starting filedialog to select a directory. Error: {re}.\n"
+ f"Setting the default location to the program directory '{target_directory}'."
)
CustomDialog(
f"ClipCascade 📥: Saving files to the program directory '{target_directory}'.",
msg_type="info",
timeout=5000,
).mainloop()
# Save each file to the chosen directory
for filename, file_obj in files.items():
file_path = os.path.join(target_directory, filename)
with open(file_path, "wb") as f:
f.write(file_obj.getvalue())
logging.debug(f"Saved: {file_path}")
except Exception as e:
msg = f"An error occurred while downloading files. Error: {e}"
logging.error(msg)
CustomDialog(
msg,
msg_type="error",
).mainloop()
def _on_logoff(self, icon, item):
try:
if self.on_logoff_callback:
self.on_logoff_callback()
self.icon.stop()
self.root.quit()
except Exception as e:
CustomDialog(
f"An error occurred while logging off: {e}", msg_type="error"
).mainloop()
def _on_quit(self, icon, item):
self.icon.stop()
self.root.quit()
-1
View File
@@ -1 +0,0 @@
https://github.com/Sathvik-Rao/ClipCascade
-46
View File
@@ -1,46 +0,0 @@
from abc import ABC, abstractmethod
from cli.tray import TaskbarPanel
from core.config import Config
class WSInterface(ABC):
############################
# ABSTRACT VARIABLES #
############################
is_auto_reconnecting: bool = False
@abstractmethod
def __init__(self, config: Config, is_login_phase=True):
"""This method must be implemented in subclasses."""
pass
@abstractmethod
def get_total_timeout(self):
"""This method must be implemented in subclasses."""
pass
@abstractmethod
def get_stats(self):
"""This method must be implemented in subclasses."""
pass
@abstractmethod
def connect(self):
"""This method must be implemented in subclasses."""
pass
@abstractmethod
def set_tray_ref(self, sys_tray: TaskbarPanel):
"""This method must be implemented in subclasses."""
pass
@abstractmethod
def manual_reconnect(self):
"""This method must be implemented in subclasses."""
pass
@abstractmethod
def disconnect(self):
"""This method must be implemented in subclasses."""
pass
-23
View File
@@ -1,23 +0,0 @@
#!/usr/bin/env python3
# ClipCascade - A seamless clipboard syncing utility
# Repository: https://github.com/Sathvik-Rao/ClipCascade
#
# Author: Sathvik Rao Poladi
# License: GPL-3.0
#
# This script serves as the entry point for the ClipCascade application,
# initializing and running the core application logic.
from core.application import Application
class Main:
def __init__(self):
Application().run()
def main():
Main()
if __name__ == "__main__":
main()
File diff suppressed because it is too large. Load diff
-84
View File
@@ -1,84 +0,0 @@
[build-system]
requires = ["setuptools>=65.0", "wheel"]
build-backend = "setuptools.build_meta"
[project]
name = "ClipCascade"
version = "3.2.0"
description = "ClipCascade is a lightweight utility that automatically syncs the clipboard across devices, no key press required."
authors = [{ name = "Sathvik Rao", email = "sathvik.poladi@gmail.com" }]
license = { file = "LICENSE" }
requires-python = ">=3.8"
keywords = [
"clipboard",
"sync",
"cross-platform",
"open-source",
"utility",
"encryption",
]
classifiers = [
"Development Status :: 3 - Alpha",
"Intended Audience :: End Users/Desktop",
"License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Topic :: System :: Monitoring",
]
dependencies = [
"Pillow>=10.4.0",
"plyer==2.1.0",
"pycryptodome==3.20.0",
"pystray==0.19.5",
"Requests==2.32.3",
"websocket_client==1.8.0",
"xxhash==3.5.0",
"beautifulsoup4==4.12.3",
"aiortc==1.10.0",
# Platform-specific dependencies
"pyfiglet==1.0.2; sys_platform == 'linux'",
"pyperclip==1.8.2; sys_platform == 'win32' or sys_platform == 'darwin'",
"pywin32==306; sys_platform == 'win32'",
"certifi; sys_platform == 'darwin'",
"pyobjus==1.2.3; sys_platform == 'darwin'",
"pasteboard==0.4.0; sys_platform == 'darwin'",
]
[project.scripts]
clipcascade = "main:main"
[tool.setuptools]
py-modules = ["main"]
packages = [
"cli",
"clipboard",
"core",
"gui",
"interfaces",
"p2p",
"stomp_ws",
"utils",
]
[tool.black]
line-length = 100
target-version = ["py38", "py39", "py310", "py311", "py312"]
include = "\\.pyi?$"
[tool.isort]
profile = "black"
line_length = 100
multi_line_mode = 3
[project.urls]
Homepage = "https://clipcascade.sathvik.dev/"
Repository = "https://github.com/Sathvik-Rao/ClipCascade"
Documentation = "https://github.com/Sathvik-Rao/ClipCascade#readme"
Issues = "https://github.com/Sathvik-Rao/ClipCascade/issues"
Discussions = "https://github.com/Sathvik-Rao/ClipCascade/discussions"
-10
View File
@@ -1,10 +0,0 @@
Pillow==10.4.0
plyer==2.1.0
pycryptodome==3.20.0
pystray==0.19.5
Requests==2.32.3
websocket_client==1.8.0
xxhash==3.5.0
pyfiglet==1.0.2
beautifulsoup4==4.12.3
aiortc==1.10.0
-206
View File
@@ -1,206 +0,0 @@
import time
from threading import Thread
from .frame import Frame
import websocket
import logging
from core.constants import *
VERSIONS = "1.0,1.1"
class Client:
def __init__(self, url, headers={}, on_close_callback=None, sslopt=None):
self.url = url
self._ws_sslopt = sslopt
self.ws = websocket.WebSocketApp(self.url, headers)
self.ws.on_open = self._on_open
self.ws.on_message = self._on_message
self.ws.on_error = self._on_error
self.ws.on_close = self._on_close
self.on_close_callback = on_close_callback
self.opened = False
self.connected = False
self.counter = 0
self.subscriptions = {}
self._connectCallback = None
self.errorCallback = None
def _connect(self, timeout=0):
if self._ws_sslopt:
thread = Thread(
target=lambda: self.ws.run_forever(sslopt=self._ws_sslopt)
)
else:
thread = Thread(target=self.ws.run_forever)
thread.daemon = True
thread.start()
total_ms = 0
while self.opened is False:
time.sleep(0.25)
total_ms += 250
if 0 < timeout < total_ms:
raise TimeoutError(f"Connection to {self.url} timed out")
def _on_open(self, ws_app, *args):
self.opened = True
def _on_close(self, ws_app, *args):
self.connected = False
logging.debug("Whoops! Lost connection to " + self.ws.url)
if self.on_close_callback is not None:
self.on_close_callback()
self._clean_up()
def _on_error(self, ws_app, error, *args):
logging.debug(error)
def _on_message(self, ws_app, message, *args):
if message == "\n": # If message is a newline, it's a heartbeat frame
logging.debug("Received heartbeat frame")
self.ws.send("\n") # Send a heartbeat back to the server
logging.debug("Sent heartbeat frame")
return
logging.debug("\n<<< " + str(message))
frame = Frame.unmarshall_single(message)
_results = []
if frame.command == "CONNECTED":
self.connected = True
logging.debug("connected to server " + self.url)
if self._connectCallback is not None:
_results.append(self._connectCallback(frame))
elif frame.command == "MESSAGE":
subscription = frame.headers["subscription"]
if subscription in self.subscriptions:
onreceive = self.subscriptions[subscription]
messageID = frame.headers["message-id"]
def ack(headers):
if headers is None:
headers = {}
return self.ack(messageID, subscription, headers)
def nack(headers):
if headers is None:
headers = {}
return self.nack(messageID, subscription, headers)
frame.ack = ack
frame.nack = nack
_results.append(onreceive(frame))
else:
info = "Unhandled received MESSAGE: " + str(frame)
logging.debug(info)
_results.append(info)
elif frame.command == "RECEIPT":
pass
elif frame.command == "ERROR":
if self.errorCallback is not None:
_results.append(self.errorCallback(frame))
else:
info = "Unhandled received MESSAGE: " + frame.command
logging.debug(info)
_results.append(info)
return _results
def _transmit(self, command, headers, body=None):
out = Frame.marshall(command, headers, body)
logging.debug("\n>>> " + out)
self.ws.send(out)
def connect(
self,
login=None,
passcode=None,
headers=None,
connectCallback=None,
errorCallback=None,
timeout=0,
):
logging.debug("Opening web socket...")
self._connect(timeout)
headers = headers if headers is not None else {}
headers["host"] = self.url
headers["accept-version"] = VERSIONS
headers["heart-beat"] = "0,20000"
if login is not None:
headers["login"] = login
if passcode is not None:
headers["passcode"] = passcode
self._connectCallback = connectCallback
self.errorCallback = errorCallback
self._transmit("CONNECT", headers)
def disconnect(self, disconnectCallback=None, headers=None):
if headers is None:
headers = {}
# self._transmit("DISCONNECT", headers) # comment this
self.ws.on_close = None
self.ws.close()
self._clean_up()
if disconnectCallback is not None:
disconnectCallback()
def _clean_up(self):
self.connected = False
def send(self, destination, headers=None, body=None):
if headers is None:
headers = {}
if body is None:
body = ""
headers["destination"] = destination
return self._transmit("SEND", headers, body)
def subscribe(self, destination, callback=None, headers=None):
if headers is None:
headers = {}
if "id" not in headers:
headers["id"] = "sub-" + str(self.counter)
self.counter += 1
headers["destination"] = destination
self.subscriptions[headers["id"]] = callback
self._transmit("SUBSCRIBE", headers)
def unsubscribe():
self.unsubscribe(headers["id"])
return headers["id"], unsubscribe
def unsubscribe(self, id):
del self.subscriptions[id]
return self._transmit("UNSUBSCRIBE", {"id": id})
def ack(self, message_id, subscription, headers):
if headers is None:
headers = {}
headers["message-id"] = message_id
headers["subscription"] = subscription
return self._transmit("ACK", headers)
def nack(self, message_id, subscription, headers):
if headers is None:
headers = {}
headers["message-id"] = message_id
headers["subscription"] = subscription
return self._transmit("NACK", headers)
-51
View File
@@ -1,51 +0,0 @@
from urllib.parse import urlparse
Byte = {"LF": "\x0A", "NULL": "\x00"}
class Frame:
def __init__(self, command, headers, body):
self.command = command
self.headers = headers
self.body = "" if body is None else body
def __str__(self):
lines = [self.command]
skipContentLength = "content-length" in self.headers
if skipContentLength:
del self.headers["content-length"]
for name in self.headers:
value = self.headers[name]
lines.append("" + name + ":" + value)
if self.body is not None and not skipContentLength:
lines.append("content-length:" + str(len(self.body)))
lines.append(Byte["LF"] + self.body)
return Byte["LF"].join(lines)
@staticmethod
def unmarshall_single(data):
lines = data.split(Byte["LF"])
command = lines[0].strip()
headers = {}
# get all headers
i = 1
while lines[i] != "":
# get key, value from raw header
(key, value) = lines[i].split(":", 1)
headers[key] = value
i += 1
# set body to None if there is no body
body = None if lines[i + 1] == Byte["NULL"] else lines[i + 1][:-1]
return Frame(command, headers, body)
@staticmethod
def marshall(command, headers, body):
return str(Frame(command, headers, body)) + Byte["NULL"]
-161
View File
@@ -1,161 +0,0 @@
import json
import logging
import time
from interfaces.ws_interface import WSInterface
from stomp_ws.client import Client
from core.config import Config
from utils.cipher_manager import CipherManager
from clipboard.clipboard_manager import ClipboardManager
from utils.notification_manager import NotificationManager
from utils.request_manager import RequestManager
from utils.ssl_helper import websocket_sslopt_for_config
from core.constants import *
if PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI:
from cli.tray import TaskbarPanel
else:
from gui.tray import TaskbarPanel
class STOMPManager(WSInterface):
def __init__(self, config: Config, is_login_phase=True):
self.config = config
self.clipboard_manager = ClipboardManager(self.config)
self.cipher_manager = CipherManager(self.config)
self.notification_manager = NotificationManager(self.config)
self.sys_tray: TaskbarPanel = None
self.first_conn_lost = True
self.is_login_phase = is_login_phase
self.client = None
self.is_connected = False
self.disconnected = False
self.is_auto_reconnecting = False
def set_tray_ref(self, sys_tray: TaskbarPanel):
"""
Sets the system tray reference.
"""
self.sys_tray = sys_tray
self.clipboard_manager.set_tray_ref(sys_tray)
def get_total_timeout(self):
"""
Returns the total timeout value in milliseconds."""
return (RECONNECT_WS_TIMER * 1000) + WEBSOCKET_TIMEOUT
def get_stats(self):
return None
def connect(self) -> tuple[bool, str]:
try:
if self.is_connected:
return True, ""
self.client = Client(
self.config.data["websocket_url"],
headers={
"Cookie": RequestManager.format_cookie(
self.config.data["cookie"]
)
},
on_close_callback=self._on_close,
sslopt=websocket_sslopt_for_config(self.config),
)
self.client.connect(
timeout=WEBSOCKET_TIMEOUT,
connectCallback=lambda _: self.client.subscribe( # receive event
destination=SUBSCRIPTION_DESTINATION,
callback=self._receive,
),
)
if self.disconnected:
self.disconnect()
return False, "Websocket disconnected"
# logging.info("Websocket connected")
self.is_connected = True
self.is_auto_reconnecting = False
if not self.first_conn_lost:
self.first_conn_lost = True
self.notification_manager.notify(
title=f"{APP_NAME}: WebSocket Connection Restored 🔗",
message="Connection re-established",
)
# send event
self.clipboard_manager.on_copy(self.send)
return True, "Websocket connected"
except Exception as e:
msg = f"Failed to connect websocket: {e}"
logging.error(msg)
return False, msg
def _on_close(self):
self.is_connected = False
# Auto Reconnect
if not self.is_login_phase and not self.disconnected:
self.is_auto_reconnecting = True
if self.first_conn_lost:
self.notification_manager.notify(
title=f"{APP_NAME}: WebSocket Connection Lost ⛓️‍💥",
message="Check your internet connection. Retrying...",
)
self.first_conn_lost = False
time.sleep(RECONNECT_WS_TIMER) # seconds
self.connect()
def send(self, payload: str, payload_type: str = "text"):
try:
if self.is_connected:
if self.clipboard_manager.has_clipboard_changed(payload):
if self.config.data["cipher_enabled"]:
payload = CipherManager.encode_to_json_string(
**self.cipher_manager.encrypt(payload)
)
body = json.dumps({"payload": payload, "type": payload_type})
self.client.send(destination=SEND_DESTINATION, body=body)
except Exception as e:
logging.error(f"Failed to send data: {e}")
def _receive(self, frame: any) -> str:
try:
if self.is_connected:
body = json.loads(frame.body)
payload = body["payload"]
payload_type = body.get("type", "text")
if self.config.data["cipher_enabled"]:
payload = self.cipher_manager.decrypt(
**CipherManager.decode_from_json_string(payload)
)
if self.clipboard_manager.has_clipboard_changed(payload):
self.clipboard_manager.base64_to_clipboard(
base64_string=payload, type_=payload_type
)
except json.decoder.JSONDecodeError:
logging.error(
"If cipher is enabled, please make sure it is enabled on all devices"
)
except Exception as e:
logging.error(f"Failed to receive data: {e}")
def manual_reconnect(self):
if not self.is_auto_reconnecting:
self.disconnected = False
self.connect()
def disconnect(self):
try:
self.clipboard_manager.previous_clipboard_hash = 0
self.disconnected = True
self.first_conn_lost = True
try:
self.client.disconnect()
self.is_connected = False
logging.info("Websocket disconnected")
except Exception as e:
pass # silent catch
self.clipboard_manager.stop()
except Exception as e:
logging.error(f"Failed to disconnect websocket: {e}")
-109
View File
@@ -1,109 +0,0 @@
import base64
import json
import hashlib
from Crypto.Cipher import AES
from core.constants import *
from core.config import Config
class CipherManager:
def __init__(self, config: Config):
self.config = config
# hash
self.hash_name = "sha256"
self.dklen = 32 # 256 bits for AES-256
# encryption
self.mode = AES.MODE_GCM
def hash_password(self, password: str) -> bytes:
return hashlib.pbkdf2_hmac(
hash_name=self.hash_name,
password=password.encode(),
salt=(
self.config.data["username"] + password + self.config.data["salt"]
).encode("utf-8"),
iterations=self.config.data["hash_rounds"],
dklen=self.dklen,
)
def encrypt(self, plaintext: str) -> dict:
key = self.config.data["hashed_password"]
plaintext_bytes = plaintext.encode("utf-8")
cipher = AES.new(key, self.mode)
ciphertext, tag = cipher.encrypt_and_digest(plaintext_bytes)
return {"nonce": cipher.nonce, "ciphertext": ciphertext, "tag": tag}
def decrypt(self, nonce: bytes, ciphertext: bytes, tag: bytes) -> str:
key = self.config.data["hashed_password"]
cipher = AES.new(key, self.mode, nonce=nonce)
return cipher.decrypt_and_verify(ciphertext, tag).decode()
@staticmethod
def encode_to_json_string(**kwargs: bytes) -> str:
"""
Convert bytes values to Base64 and create a JSON string.
Args:
**kwargs: Key-value pairs where values must be of type `bytes`.
Returns:
str: A JSON string with all `bytes` values Base64-encoded.
Raises:
ValueError: If a value is not of type `bytes`.
"""
json_data = {}
for key, value in kwargs.items():
if isinstance(value, bytes):
json_data[key] = base64.b64encode(value).decode("utf-8")
else:
raise ValueError(
f"Unsupported value type for key '{key}': {type(value)}. "
f"This method only supports 'bytes'."
)
return json.dumps(json_data)
@staticmethod
def decode_from_json_string(json_string: str) -> dict:
"""
Decode a JSON string where all values are Base64-encoded back to their original bytes.
Args:
json_string (str): A JSON string with Base64-encoded values.
Returns:
dict: A dictionary with the original keys and `bytes` values decoded from Base64.
Raises:
ValueError: If the JSON string is not valid or if decoding fails.
"""
# Parse the JSON string into a dictionary
json_data = json.loads(json_string)
decoded_data = {}
# Decode each Base64-encoded value back to bytes
for key, value in json_data.items():
if isinstance(value, str):
decoded_data[key] = base64.b64decode(value)
else:
raise ValueError(
f"Unsupported value type for key '{key}': {type(value)}. "
+ f"Expected 'str' for Base64 decoding."
)
return decoded_data
@staticmethod
def string_to_sha3_512_lowercase_hex(input_string: str) -> str:
"""
Convert a string to its lowercase hexadecimal SHA3-512 hash.
Args:
input_string (str): The input string to hash.
Returns:
str: The lowercase hexadecimal representation of the SHA3-512 hash.
"""
return hashlib.sha3_512(input_string.encode("utf-8")).hexdigest()
-42
View File
@@ -1,42 +0,0 @@
from core.constants import *
from core.config import Config
if PLATFORM == WINDOWS or (
PLATFORM.startswith(LINUX) and not LINUX_USE_CLI_UI
):
# WINDOWS: When creating the executable with pyinstaller, add --hidden-import plyer.platforms.win.notification
from plyer import notification
elif PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI:
from cli.info import CustomDialog
elif PLATFORM == MACOS:
import subprocess
class NotificationManager:
def __init__(self, config: Config):
self.config = config
def notify(self, title: str, message: str, app_name: str = APP_NAME, timeout=10):
if self.config.data["notification"]: # Check if notifications are enabled
try:
if PLATFORM == WINDOWS or (
PLATFORM.startswith(LINUX) and not LINUX_USE_CLI_UI
):
notification.notify(
title=title,
message=message,
app_name=app_name,
timeout=timeout, # seconds
)
elif PLATFORM.startswith(LINUX) and LINUX_USE_CLI_UI:
CustomDialog(f"{title} : {message}").mainloop()
elif PLATFORM == MACOS:
subprocess.run(
[
"osascript",
"-e",
f'display notification "{message}" with title "{title}"',
]
)
except Exception as e:
logging.error(f"Failed to handle notification: {e}")
-201
View File
@@ -1,201 +0,0 @@
import json
import logging
import requests
from core.constants import *
from core.config import Config
from bs4 import BeautifulSoup
from utils.ssl_helper import requests_verify_arg
class RequestManager:
def __init__(self, config: Config):
self.config = config
def _verify(self):
return requests_verify_arg(self.config)
@staticmethod
def format_cookie(cookie: dict) -> str:
"""
Format the cookie string for headers.
"""
return f"JSESSIONID={cookie.get('JSESSIONID', '')};"
def login(self) -> tuple[bool, str, dict]:
try:
session = requests.Session()
# Fetch the login page to get the CSRF token
response = session.get(
self.config.data["server_url"] + LOGIN_URL,
verify=self._verify(),
)
if response.status_code != 200:
msg = f"Failed to fetch login page: {response.status_code}"
logging.error(msg)
return False, msg, None
soup = BeautifulSoup(response.text, "html.parser")
csrf_token = soup.find("input", {"name": "_csrf"})["value"]
# Login with the credentials
form_data = {
"username": self.config.data["username"],
"password": self.config.data["password"],
"_csrf": csrf_token,
}
response = session.post(
self.config.data["server_url"] + LOGIN_URL,
data=form_data,
verify=self._verify(),
)
if (
response.status_code == 200
and "bad credentials" not in response.text.lower()
):
# login successful
cookie = session.cookies.get_dict()
logging.info(f"Login successful: {response.status_code}")
return True, "Login successful", cookie
else:
# login failed
msg = f"Login failed: {response.status_code}"
logging.error(msg)
return False, msg, None
except Exception as e:
msg = f"An error occurred during login: {e}"
logging.error(msg)
return False, msg, None
def maxsize(self) -> int:
try:
response = RequestManager.get(
url=self.config.data["server_url"] + MAXSIZE_URL,
headers={
"Cookie": RequestManager.format_cookie(self.config.data["cookie"])
},
verify=self._verify(),
)
if response.status_code == 200:
# maxsize request successful
maxsize = response.json().get("maxsize", MAX_SIZE)
logging.info(f"Max size: {maxsize}")
return maxsize
except Exception as e:
logging.error(
f"Error fetching max size: {e}, defaulting to {MAX_SIZE} Bytes"
)
return MAX_SIZE
def get_server_mode(self) -> str:
try:
response = RequestManager.get(
url=self.config.data["server_url"] + SERVER_MODE_URL,
headers={
"Cookie": RequestManager.format_cookie(self.config.data["cookie"])
},
verify=self._verify(),
)
if response.status_code == 200:
# server mode request successful
server_mode = response.json().get("mode")
logging.info(f"Server mode: {server_mode}")
return server_mode
except Exception as e:
logging.error(f"Error fetching server mode: {e}")
raise
def get_stun_url(self) -> str:
try:
response = RequestManager.get(
url=self.config.data["server_url"] + STUN_URL,
headers={
"Cookie": RequestManager.format_cookie(self.config.data["cookie"])
},
verify=self._verify(),
)
if response.status_code == 200:
# stun url request successful
stun_url = response.json().get("url")
logging.info(f"STUN URL: {stun_url}")
return stun_url
except Exception as e:
logging.error(f"Error fetching STUN URL: {e}")
raise
def get_metadata(self) -> dict:
try:
response = RequestManager.get(
url=METADATA_URL,
headers={
"Cookie": RequestManager.format_cookie(self.config.data["cookie"])
},
verify=True,
)
if response.status_code == 200:
# metadata request successful
return response.json()
except Exception as e:
logging.error(f"Error fetching metadata: {e}")
raise
def logout(self):
try:
response = RequestManager.post(
url=self.config.data["server_url"] + LOGOUT_URL,
data={"_csrf": self.config.data["csrf_token"]},
headers={
"Cookie": RequestManager.format_cookie(self.config.data["cookie"])
},
verify=self._verify(),
)
if response.status_code == 204:
logging.info(f"Logout successful: {response.status_code}")
except Exception as e:
logging.error(f"Error during logout: {e}")
def get_csrf_token(self) -> str:
try:
response = RequestManager.get(
url=self.config.data["server_url"] + CSRF_URL,
headers={
"Cookie": RequestManager.format_cookie(self.config.data["cookie"])
},
verify=self._verify(),
)
if response.status_code == 200:
# CSRF token request successful
return json.loads(response.text).get("token", "")
except Exception as e:
logging.error(f"Error fetching CSRF token: {e}")
return ""
@staticmethod
def get(url: str, headers: dict = None, verify=True) -> requests.Response:
"""
A generic GET mapper for handling GET requests.
"""
try:
response = requests.get(url, headers=headers, verify=verify)
response.raise_for_status() # Will raise an HTTPError if the HTTP request returned an unsuccessful status code
return response
except Exception as e:
logging.error(f"Error during GET request to {url}: {e}")
raise
@staticmethod
def post(
url: str, data: dict, headers: dict = None, verify=True
) -> requests.Response:
"""
A generic POST mapper for handling POST requests.
"""
try:
response = requests.post(url, data=data, headers=headers, verify=verify)
response.raise_for_status() # Will raise an HTTPError if the HTTP request returned an unsuccessful status code
return response
except Exception as e:
logging.error(f"Error during POST request to {url}: {e}")
raise
-32
View File
@@ -1,32 +0,0 @@
import os
import ssl
from typing import Any, Dict, Optional, Union
from core.constants import MACOS, PLATFORM
if PLATFORM == MACOS:
import certifi
def requests_verify_arg(config) -> Union[bool, str]:
"""Argument for requests' verify= when calling the user's server."""
path = (config.data.get("ssl_ca_bundle") or "").strip()
if not path:
return True
if not os.path.isfile(path):
raise FileNotFoundError(f"SSL CA bundle file not found: {path}")
return path
def websocket_sslopt_for_config(config) -> Optional[Dict[str, Any]]:
"""sslopt for websocket_client run_forever; None uses the library/OS default."""
path = (config.data.get("ssl_ca_bundle") or "").strip()
if path:
if not os.path.isfile(path):
raise FileNotFoundError(f"SSL CA bundle file not found: {path}")
ctx = ssl.create_default_context(cafile=path)
return {"context": ctx}
if PLATFORM == MACOS:
ctx = ssl.create_default_context(cafile=certifi.where())
return {"context": ctx}
return None
-45
View File
@@ -1,45 +0,0 @@
import logging
import re
from core.constants import *
def center_window(win, max_height=None):
"""Center a Tk/Toplevel window on the primary monitor."""
logging.debug(f"Centering window with max_height={max_height}")
win.update_idletasks()
window_width = win.winfo_width()
window_height = win.winfo_height()
if max_height:
window_height = min(window_height, max_height)
logging.debug(f"Window dimensions: {window_width}x{window_height}")
primary_x, primary_y = 0, 0
primary_w, primary_h = win.winfo_screenwidth(), win.winfo_screenheight()
try:
if PLATFORM.startswith(LINUX):
logging.debug("Detecting monitors on Linux platform")
import subprocess
result = subprocess.run(
["xrandr", "--query"], capture_output=True, text=True, timeout=2
)
for line in result.stdout.splitlines():
if " connected primary" in line:
m = re.search(r"(\d+)x(\d+)\+(\d+)\+(\d+)", line)
if m:
primary_w = int(m.group(1))
primary_h = int(m.group(2))
primary_x = int(m.group(3))
primary_y = int(m.group(4))
logging.debug(
f"Primary monitor: position=({primary_x}, {primary_y}), size={primary_w}x{primary_h}"
)
break
except Exception as e:
logging.warning(f"Failed to detect primary monitor: {e}. Using fallback dimensions.")
x = primary_x + (primary_w - window_width) // 2
y = primary_y + (primary_h - window_height) // 2
x = max(primary_x, x)
y = max(primary_y, y)
logging.debug(f"Calculated window position: ({x}, {y})")
win.geometry(f"{window_width}x{window_height}+{x}+{y}")
logging.debug(f"Applied geometry: {window_width}x{window_height}+{x}+{y}")
+2 -2
View File
@@ -1,5 +1,5 @@
{ {
"version": "0.8.0", "version": "0.8.2",
"body": "### Added\n- Added `herdr --skill` to print the agent skill bundled with the running Herdr binary.\n- Added `ui.pane_scrollbars = false` to hide terminal pane scrollbars and reclaim their reserved column. (#2167)\n- Added `ui.tab_bar_position = \"bottom\"` to place the desktop tab row below terminal panes. (#2117)\n- Added live filtering to the keybind help with `/`, Backspace, and `Ctrl+U`. (#1825, #1832, thanks @corrius)\n- Added Windows support for `experimental.switch_ascii_input_source_in_prefix` with Korean IMEs. (#1802, #1823, thanks @joonhwan)\n- Added Grok CLI session reporting and native restore with `grok --resume <id>`. (#1800, #1807, thanks @carlesso)\n- Added Antigravity CLI session reporting and native restore with `agy --conversation <id>`. (#1011, #1571, #2087, thanks @ludoo)\n- Added automatic text history reads for idle alternate-screen agents, with the application viewport restored after collection.\n- Added `workspace.move_block`, the `workspace.reordered` event, and atomic worktree-group reordering. (#1694)\n- Added a Simplified Chinese README. (#1990, thanks @patrick-xin)\n\n### Changed\n- Experimental options are no longer exposed in the Settings TUI and remain available through the config file.\n- Agent status indicators now use the same static workspace marks across the sidebar, navigator, and mobile views, eliminating continuous spinner rendering while agents work.\n- Hidden pane output no longer triggers unnecessary TUI rendering.\n- Windows preview downloads now include Herdr and a modern app-local ConPTY runtime in one archive. (#1533, #1644, #1828)\n- Worktree parents and children now stay packed together in the sidebar, including while groups are reordered.\n- Public documentation now separates stable, preview, and immutable versioned release snapshots.\n- Repository and installation links now use `herdrdev/herdr` after the GitHub organization migration.\n- Relicensed Herdr from AGPL-3.0-or-later to Apache-2.0.\n\n### Fixed\n- Pane applications now receive semantic light/dark query responses and live Mode 2031 updates when the host appearance changes. (#714)\n- Remote attach now falls back to `sh` when the login shell cannot perform path discovery. (#1201)\n- PTY output continues to be read while pane input is temporarily blocked. (#1295)\n- Worktree CLI help and docs no longer advertise the redundant `--json` flag; worktree commands remain JSON-only and continue accepting the flag for compatibility. (#2171)\n- OpenCode 2 preview panes now appear as OpenCode agents and use the existing OpenCode status detection. (#2169)\n- Pane text copied through VS Code Remote Tunnels now reaches the viewing machine's clipboard instead of overwriting the remote host clipboard. (#2015)\n- Windows agent detection now follows Git Bash-launched agents across emulated `exec` process boundaries. (#2107)\n- Detached Windows servers and pane processes now survive logout from the OpenSSH session that started them. (#2008)\n- Windows `agent start` now launches agents without native arguments instead of timing out on an invalid empty PowerShell argument list. (#2072)\n- Headless servers now resume restored agent sessions without waiting for a TUI client to attach. (#2064)\n- Vibe and other Kitty-keyboard pane applications now receive shifted letters and punctuation when they request associated text. (#2020)\n- Kitty-keyboard pane applications now receive printable key releases without duplicate text input. (#1746)\n- Kitty graphics remain visible during host repaints. (#1628)\n- Pane applications now receive correct XTWINOPS terminal and cell-size query responses. (#835)\n- WSL clients query the host cell size when the terminal ioctl reports no pixels, keeping graphics sharp instead of using the 8x16 fallback. (#2146, #2160, thanks @WakaTaira)\n- Linux runtimes without terminal foreground process groups can opt into child-group agent detection with `HERDR_PROCESS_DETECTION=child-groups`. (#1982)\n- Installing the Herdr agent skill with the `skills` CLI no longer copies the entire repository. (#2022)\n- Nix builds now include the bundled agent skill required by `herdr --skill`. (#1889, #1890, thanks @olafkfreund)\n- Agent prompts now wait briefly after sending text before pressing Enter, preventing prompts from remaining in agent composers without starting a turn. (#1878)\n- Empty clipboard writes from pane applications no longer erase existing clipboard contents or show a copied confirmation. (#1893)\n- Plain mouse movement no longer triggers continuous full renders while preserving Herdr menu hover and pane application mouse tracking. (#1865)\n- Extended-button drags now preserve Herdr hover state while applications receive the drag.\n- `ui.copy_on_select = false` now retains drag and double-click word selections without copying; `Ctrl+C`, or `Cmd+C` when the host terminal forwards it, copies and clears the selection. (#1782)\n- Pane and agent read responses now report `truncated: true` wLine truncated "body": "### Added\n- CLI help now points coding agents to Herdr's plain-text guide, documentation index, and built-in control skill.\n- Added Qwen Code detection for idle, working, and user-confirmation states, plus optional native session restore. (#2730, #2743)\n- Herdr now keeps the outer terminal window title in sync with the session through `ui.window_title`, so window managers and terminal tab bars show the active workspace and the host the panes actually run on. (#2627, thanks @dhh)\n- The desktop tab bar now has configurable right-aligned status entries for zoom state, hostname, date/time, literal text, and asynchronously refreshed command output.\n- Optional `keys.move_tab_previous` and `keys.move_tab_next` bindings now reorder the active tab in place, wrapping at either end. (#2561, thanks @dhh)\n- Optional `keys.resize_pane_left`, `keys.resize_pane_down`, `keys.resize_pane_up`, and `keys.resize_pane_right` bindings now resize the focused pane in one keystroke without entering resize mode. (#2558, thanks @dhh)\n- Windows clients can now use `herdr --remote` to attach to Herdr servers on Linux and macOS. (#2329)\n- Cursor Agent CLI, MastraCode, Hermes Agent, and Grok CLI integrations now install and run natively on Windows.\n- Panes can now route normal right-click gestures to mouse-reporting applications through the pane menu, `herdr pane input`, `pane.input.set`, or the `pane split --right-click pane` launch option.\n- `ui.pane_outer_borders` can now keep or hide the outside edges of split-pane borders independently from internal dividers. (#2535, thanks @dhh)\n- `theme.custom.sidebar_bg` can now give the desktop sidebar its own background without changing built-in theme defaults.\n- Settings and `ui.status_indicators = \"symbols\"` can now use distinct static shapes for blocked, working, done, idle, and unknown agent states. (#2260)\n- Navigate-mode selection rows now use a dedicated per-theme cursor color, customizable via `theme.custom.selection_bg`, so the cursor stays distinguishable from the active Space and Agent highlight.\n- Copy mode now supports `B`, `E`, and `W` motions over whitespace-delimited big words. (#2270, thanks @jplew)\n- The plugin marketplace now discovers valid manifests at repository roots and subdirectories, groups multiple plugins under each repository, and publishes their versions and exact default-branch commits.\n\n### Changed\n- Windows support is now generally available through stable releases and uses the stable update channel by default. Existing preview installs stay on preview until explicitly switched.\n- Headless servers now use a configurable 120×40 virtual terminal instead of 80×24 when no client is attached, giving newly created panes a practical default size. (#2828)\n- Desktop tab labels are now centered in their tabs, so the active-tab highlight has symmetric padding. (#2570, thanks @dhh)\n- Experimental pane graphics now support bounded named layers, acknowledged full-RGBA primary-layer direct file frames on audited local terminals, owned BGRA fallback, exact pixel mouse input, and placement-only resize replay.\n\n### Fixed\n- Unix CLI commands now exit quietly when a downstream pipe closes instead of panicking with exit 101. (#2994)\n- The terminal theme now keeps the active Space row fill visible when the Navigate cursor lands on it, in both expanded and collapsed sidebars. (#2987)\n- Busy multi-pane sessions now avoid redundant hidden-pane wakeups and full terminal-state formatting in pane-scaled paths, preventing CPU regressions from high-rate background output, scrollbars, and enhanced keyboard modes. (#2550, #2901, #2962)\n- Chinese IME commits now reach panes on macOS when the focused application requests printable key-release events. (#2924)\n- Windows now recognizes `Ctrl+1` through `Ctrl+9` keybindings instead of decoding those key records as control characters. (#2910)\n- PowerShell panes now keep their process-reported working directory synchronized with the shell's logical location. (#2879, thanks @Pimpmuckl)\n- Foreground typing no longer waits behind render cadence consumed by output from panes in hidden tabs. (#2890)\n- The Windows ARM64 installer now waits for x64 emulation to release the verified executable before activating the downloaded release. (#2916)\n- On Unix, Ctrl-click URL openers are now reaped after they exit, preventing defunct child processes from accumulating on long-running servers. (#2903)\n- Windows updates now reuse only verified local packages, avoiding security-tool download blocks while preserving checksum validation. (#2751, #2816, thanks @Pimpmuckl)\n- Herdr no longer sends the full OSC 4 palette query burst under WSL, preventing reply fragments from leaking into the shell through ConPTY. (#2440)\n- Qwen Code panes now use locale-independent terminal-title states and localized confirmation fallbacks, preventing active or blocked turns from appearing idle. (#2756)\n- Claude Code panes now recognize and stLine truncated
"show_on_startup": true "show_on_startup": true
} }
@@ -5,33 +5,33 @@
"tabs": [ "tabs": [
{ {
"panes": { "panes": {
"1": { "7": {
"ansi": "\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2msed\u001b[0m -n \u001b[0m\u001b[38;5;3m'103,111p'\u001b[0m \u001b[0m\u001b[4m~/.config/yazi/init.lua\u001b[0m\r\nrequire(\"mime-ext.local\"):setup({\r\n with_exts = {\r\n tex = \"text/makefile\",\r\n },\r\n})\r\n\r\nrequire(\"full-border\"):setup({\r\n type = ui.Border.ROUNDED,\r\n})\r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2my\u001b[0m\r\nError: Lua runtime failed\r\n\r\nCaused by:\r\n Plugin `mime-ext.local` requires at least Yazi 26.8.15, but your current version is Yazi 26.5.6 (Arch Linux 2026-06-15).\r\n stack traceback:\r\n [C]: in local 'poll'\r\n [string \"?\"]:28: in global 'require'\r\n [string \"init.lua\"]:103: in main chunk\r\n \r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[4m\u001b[38;5;2msudo\u001b[0m \u001b[0m\u001b[38;5;2mpacman\u001b[0m -S unarchiver\r\n[sudo] password for liph: \r\n\u001b[0m\u001b[1m\u001b[38;5;1merror: \u001b[0mfailed to init transaction (unable to lock database)\r\n\u001b[0m\u001b[1m\u001b[38;5;1merror: \u001b[0mcould not lock database: File exists\r\n if you're sure a package manager is not already\r\n running, you can remove /var/lib/pacman/db.lck\r\n\u001b[0m\u001b[38;5;1m❯ \u001b[0m\u001b[38;5;2my\u001b[0m\r\nError: Lua runtime failed\r\n\r\nCaused by:\r\n Plugin `mime-ext.local` requires at least Yazi 26.8.15, but your current version is Yazi 26.5.6 (Arch Linux 2026-06-15).\r\n stack traceback:\r\n [C]: in local 'poll'\r\n [string \"?\"]:28: in global 'require'\r\n [string \"init.lua\"]:103: in main chunk\r\n \r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2mcd\u001b[0m yazi\r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2mn\u001b[0m \u001b[0m\u001b[4mkeymap.toml\u001b[0m\r\n\r\n\u001b[0m\u001b[38;5;5march liph \u001b[0m\u001b[38;5;4m~/dotfiles/yazi/.config/yazi\u001b[0m\u001b[38;5;3m main* \u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯\u001b[0m ", "ansi": "neo\r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2mneo\u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;5;6m -` liph\u001b[0m@\u001b[0m\u001b[1m\u001b[38;5;6march\u001b[0m \r\n\u001b[0m\u001b[1m\u001b[38;5;6m .o+` \u001b[0m--------- \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `ooo/ OS\u001b[0m: Arch Linux x86_64 \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `+oooo: Host\u001b[0m: 20BWS3GD00 ThinkPad T450s \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `+oooooo: Kernel\u001b[0m: 6.18.48-1-lts \r\n\u001b[0m\u001b[1m\u001b[38;5;6m -+oooooo+: Uptime\u001b[0m: 3 hours, 11 mins \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `/:-:++oooo+: Packages\u001b[0m: 1682 (pacman) \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `/++++/+++++++: Shell\u001b[0m: zsh 5.9.2 \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `/++++++++++++++: Resolution\u001b[0m: 1920x1080 \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `/+++ooooooooooooo/` DE\u001b[0m: Niri \r\n\u001b[0m\u001b[1m\u001b[38;5;6m ./ooosssso++osssssso+` WM\u001b[0m: sway \r\n\u001b[0m\u001b[1m\u001b[38;5;6m .oossssso-````/ossssss+` Theme\u001b[0m: Gruvbox-Material-Dark-HIDPI [GTK2/3] \r\n\u001b[0m\u001b[1m\u001b[38;5;6m -osssssso. :ssssssso. Icons\u001b[0m: Pop [GTK2/3] \r\n\u001b[0m\u001b[1m\u001b[38;5;6m :osssssss/ osssso+++. Terminal\u001b[0m: WezTerm \r\n\u001b[0m\u001b[1m\u001b[38;5;6m /ossssssss/ +ssssooo/- CPU\u001b[0m: Intel i5-5300U (4) @ 2.900GHz \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `/ossssso+/:- -:/+osssso+- GPU\u001b[0m: Intel Broadwell-U GT2 [HD Graphics 5500 \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `+sso+:-` `.-/+oso: Memory\u001b[0m: 4376MiB / 7635MiB \r\n\u001b[0m\u001b[1m\u001b[38;5;6m `++:. `-/+/\u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;5;6m .` `/ \u001b[0m\u001b[38;5;0m\u001b[48;5;0m \u001b[0m\u001b[38;5;1m\u001b[48;5;1m \u001b[0m\u001b[38;5;2m\u001b[48;5;2m \u001b[0m\u001b[38;5;3m\u001b[48;5;3m \u001b[0m\u001b[38;5;4m\u001b[48;5;4m \u001b[0m\u001b[38;5;5m\u001b[48;5;5m \u001b[0m\u001b[38;5;6m\u001b[48;5;6m \u001b[0m\u001b[38;5;7m\u001b[48;5;7m \u001b[0m\r\n \u001b[0m\u001b[38;5;8m\u001b[48;5;8m \u001b[0m\u001b[38;5;9m\u001b[48;5;9m \u001b[0m\u001b[38;5;10m\u001b[48;5;10m \u001b[0m\u001b[38;5;11m\u001b[48;5;11m \u001b[0m\u001b[38;5;12m\u001b[48;5;12m \u001b[0m\u001b[38;5;13m\u001b[48;5;13m \u001b[0m\u001b[38;5;14m\u001b[48;5;14m \u001b[0m\u001b[38;5;15m\u001b[48;5;15m \u001b[0m\r\n\r\n\r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2my\u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2my\u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2my\u001b[0m\r\n\r\n\u001b[0m\u001b[38;5;5march liph \u001b[0m\u001b[38;5;4m/home\u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯\u001b[0m ",
"lines": 42 "lines": 30
}, },
"2": { "8": {
"ansi": "\r\n\u001b[0m\u001b[38;5;5march liph \u001b[0m\u001b[38;5;4m~/Pictures\u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯\u001b[0m ", "ansi": "\u001b[0m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63m \u001b[0m\u001b[38;2;156;66;33m\u001b[48;2;42;39;63m\u001b[0m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63m \u001b[0m\u001b[1m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63myazi.toml\u001b[0m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63m  mgr  ratio  0 \u001b[0m\r\n 1 \u001b[0m\u001b[3m\u001b[38;2;144;140;170m# A TOML linter such as Tombi can use this schema to validate your config.\u001b[0m\r\n 2 \u001b[0m\u001b[3m\u001b[38;2;144;140;170m# If you encounter any problems, please file an issue at https://github.com/y\u001b[0m \u001b[0m\u001b[3m\u001b[38;2;144;140;170mazi-rs/schemas.\u001b[0m\r\n 3 \r\n 4 \u001b[0m\u001b[3m\u001b[38;2;144;140;170m#:schema https://yazi-rs.github.io/schemas/yazi.json\u001b[0m\r\n 5 \r\n 6 \u001b[0m\u001b[1m\u001b[38;2;156;207;216m[mgr]\u001b[0m\r\n 7 \u001b[0m\u001b[38;2;224;222;244mratio\u001b[0m = [\u001b[0m\u001b[38;2;246;193;119m1\u001b[0m, \u001b[0m\u001b[38;2;246;193;119m2\u001b[0m, \u001b[0m\u001b[38;2;246;193;119m3\u001b[0m]\r\n 8 \u001b[0m\u001b[38;2;224;222;244msort_by\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m\"alphabetical\"\u001b[0m \r\n 9 \u001b[0m\u001b[38;2;224;222;244msort_sensitive\u001b[0m = \u001b[0m\u001b[38;2;234;154;151mfalse\u001b[0m \r\n 10 \u001b[0m\u001b[38;2;224;222;244msort_reverse\u001b[0m = \u001b[0m\u001b[38;2;234;154;151mfalse\u001b[0m \r\n 11 \u001b[0m\u001b[38;2;224;222;244msort_dir_first\u001b[0m = \u001b[0m\u001b[38;2;234;154;151mtrue\u001b[0m \r\n 12 \u001b[0m\u001b[38;2;224;222;244msort_translit\u001b[0m = \u001b[0m\u001b[38;2;234;154;151mfalse\u001b[0m \r\n 13 \u001b[0m\u001b[38;2;224;222;244msort_fallback\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m\"alphabetical\"\u001b[0m\r\n 14 \u001b[0m\u001b[38;2;224;222;244mlinemode\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m\"none\"\u001b[0m \r\n 15 \u001b[0m\u001b[38;2;117;77;75m┃ \u001b[0m\u001b[38;2;224;222;244mshow_hidden\u001b[0m = \u001b[0m\u001b[38;2;234;154;151mtrue\u001b[0m \r\n 16 \u001b[0m\u001b[38;2;224;222;244mshow_symlink\u001b[0m = \u001b[0m\u001b[38;2;234;154;151mtrue\u001b[0m \r\n 17 \u001b[0m\u001b[38;2;224;222;244mscrolloff\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m5\u001b[0m \r\n 18 \u001b[0m\u001b[38;2;224;222;244mmouse_events\u001b[0m = [\u001b[0m\u001b[38;2;246;193;119m\"click\"\u001b[0m, \u001b[0m\u001b[38;2;246;193;119m\"scroll\"\u001b[0m, \u001b[0m\u001b[38;2;246;193;119m\"drag\"\u001b[0m]\r\n 19 \r\n 20 \u001b[0m\u001b[1m\u001b[38;2;156;207;216m[preview]\u001b[0m \r\n 21 \u001b[0m\u001b[38;2;224;222;244mwrap\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m\"no\"\u001b[0m \r\n 22 \u001b[0m\u001b[38;2;224;222;244mtab_size\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m2\u001b[0m \r\n 23 \u001b[0m\u001b[38;2;117;77;75m┃ \u001b[0m\u001b[38;2;224;222;244mmax_width\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m800\u001b[0m \r\n 24 \u001b[0m\u001b[38;2;117;77;75m┃ \u001b[0m\u001b[38;2;224;222;244mmax_height\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m1200\u001b[0m\r\n 25 \u001b[0m\u001b[38;2;224;222;244mcache_dir\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m\"\"\u001b[0m \r\n 26 \u001b[0m\u001b[38;2;224;222;244mimage_delay\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m30\u001b[0m\r\n 27 \u001b[0m\u001b[38;2;224;222;244mimage_filter\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m\"triangle\"\u001b[0m\r\n 28 \u001b[0m\u001b[38;2;224;222;244mimage_quality\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m75\u001b[0m\r\n 29 \u001b[0m\u001b[38;2;224;222;244mueberzug_scale\u001b[0m = \u001b[0m\u001b[38;2;246;193;119m1\u001b[0m\r\n 30 \u001b[0m\u001b[38;2;224;222;244mueberzug_offset\u001b[0m = [\u001b[0m\u001b[38;2;246;193;119m0\u001b[0m, \u001b[0m\u001b[38;2;246;193;119m0\u001b[0m, \u001b[0m\u001b[38;2;246;193;119m0\u001b[0m, \u001b[0m\u001b[38;2;246;193;119m0\u001b[0m]\r\n 31 \r\n 32 \u001b[0m\u001b[1m\u001b[38;2;156;207;216m[opener]\u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;234;154;151m NORMAL \u001b[0m\u001b[38;2;234;154;151m\u001b[48;2;57;53;82m  main \u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;57;53;82m +25 \u001b[0m\u001b[38;2;234;154;151m\u001b[48;2;57;53;82m~6 \u001b[0m\u001b[38;2;235;111;146m\u001b[48;2;57;53;82m-1 \u001b[0m\u001b[38;2;57;53;82m\u001b[48;2;42;39;63m\u001b[0m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m yazi.toml \u001b[0m\u001b[38;2;57;53;82m\u001b[48;2;42;39;63m\u001b[0m\u001b[38;2;234;154;151m\u001b[48;2;57;53;82m 1% \u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;234;154;151m 7:10 \u001b[0m",
"lines": 3 "lines": 34
} }
} }
}, },
{ {
"panes": { "panes": {
"3": { "10": {
"ansi": "\u001b[0m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63m \u001b[0m\u001b[38;2;81;160;207m\u001b[48;2;42;39;63m\u001b[0m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63m \u001b[0m\u001b[1m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63mmain.lua\u001b[0m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63m \u001b[0m\u001b[38;2;235;111;146m╭────────────  Error ────────────╮\u001b[0m\u001b[38;2;144;140;170m\u001b[48;2;42;39;63m \u001b[0m\r\n 88 \u001b[0m\u001b[4m\u001b[38;2;62;143;176mlocal\u001b[0m\u001b[4m \u001b[0m\u001b[4m\u001b[38;2;62;143;176mfunction\u001b[0m\u001b[4m \u001b[0m\u001b[3m\u001b[4m\u001b[38;2;234;154;151mget_filesystem_extra\u001b[0m\u001b[4m\u001b[38;2;235;111;146m(\u001b[0m\u001b[3m\u001b[4m\u001b[38;2;196;167;231mfile\u001b[0m\u001b[4m\u001b[38;2;235;111;146m)\u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \u001b[0m\u001b[1m\u001b[38;2;235;111;146mLua callback: ...y/rainbow-delim\u001b[0m\u001b[38;2;110;106;134m…\u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \r\n 89 \u001b[0m\u001b[38;2;156;207;216m▏\u001b[0m\u001b[38;2;57;53;82m \u001b[0m\u001b[38;2;62;143;176mlocal\u001b[0m \u001b[0m\u001b[3m\u001b[38;2;224;222;244mresult\u001b[0m \u001b[0m\u001b[38;2;144;140;170m=\u001b[0m \u001b[0m\u001b[38;2;235;111;146m{\u001b[0m \u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \u001b[0m\u001b[1m\u001b[38;2;235;111;146mstack traceback:\u001b[0m\u001b[38;2;110;106;134m \u001b[0m \u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \r\n 90 \u001b[0m\u001b[38;2;156;207;216m▏\u001b[0m\u001b[38;2;57;53;82m ▏ \u001b[0m\u001b[3m\u001b[38;2;156;207;216mfilesystem\u001b[0m \u001b[0m\u001b[38;2;144;140;170m=\u001b[0m \u001b[0m\u001b[38;2;246;193;119m\"\"\u001b[0m\u001b[38;2;144;140;170m,\u001b[0m \u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \u001b[0m\u001b[1m\u001b[38;2;110;106;134m \u001b[0m\u001b[1m\u001b[38;2;235;111;146m...y/rainbow-delimiters.nvim/l\u001b[0m\u001b[38;2;110;106;134m…\u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \r\n 91 \u001b[0m\u001b[38;2;156;207;216m▏\u001b[0m\u001b[38;2;57;53;82m ▏ \u001b[0m\u001b[3m\u001b[38;2;156;207;216mdevice\u001b[0m \u001b[0m\u001b[38;2;144;140;170m=\u001b[0m \u001b[0m\u001b[38;2;246;193;119m\"\"\u001b[0m\u001b[38;2;144;140;170m,\u001b[0m \u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \u001b[0m\u001b[1m\u001b[38;2;110;106;134m \u001b[0m\u001b[1m\u001b[38;2;235;111;146m...zy/rainbow-delimiters.nvim/\u001b[0m\u001b[38;2;110;106;134m…\u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \r\n 92 \u001b[0m\u001b[38;2;156;207;216m▏\u001b[0m\u001b[38;2;57;53;82m ▏ \u001b[0m\u001b[3m\u001b[38;2;156;207;216mtype\u001b[0m \u001b[0m\u001b[38;2;144;140;170m=\u001b[0m \u001b[0m\u001b[38;2;246;193;119m\"\"\u001b[0m\u001b[38;2;144;140;170m,\u001b[0m \u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \u001b[0m\u001b[1m\u001b[38;2;110;106;134m \u001b[0m\u001b[1m\u001b[38;2;235;111;146mC: in function 'nvim_set_optio\u001b[0m\u001b[38;2;110;106;134m…\u001b[0m\u001b[38;2;235;111;146m│\u001b[0m\r\n 93 \u001b[0m\u001b[38;2;156;207;216m▏\u001b[0m\u001b[38;2;57;53;82m ▏ \u001b[0m\u001b[3m\u001b[38;2;156;207;216mused_space\u001b[0m \u001b[0m\u001b[38;2;144;140;170m=\u001b[0m \u001b[0m\u001b[38;2;246;193;119m\"\"\u001b[0m\u001b[38;2;144;140;170m,\u001b[0m \u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \u001b[0m\u001b[1m\u001b[38;2;110;106;134m \u001b[0m\u001b[1m\u001b[38;2;235;111;146m...t/.local/share/nvim/lazy/nu\u001b[0m\u001b[38;2;110;106;134m…\u001b[0m\u001b[38;2;235;111;146m│\u001b[0m\r\n 94 \u001b[0m\u001b[38;2;156;207;216m▏\u001b[0m\u001b[38;2;57;53;82m ▏ \u001b[0m\u001b[3m\u001b[38;2;156;207;216mavail_space\u001b[0m \u001b[0m\u001b[38;2;144;140;170m=\u001b[0m \u001b[0m\u001b[38;2;246;193;119m\"\"\u001b[0m\u001b[38;2;144;140;170m, \u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \u001b[0m\u001b[1m\u001b[38;2;110;106;134m \u001b[0m\u001b[1m\u001b[38;2;235;111;146m...t/.local/share/nvim/lazy/nu\u001b[0m\u001b[38;2;110;106;134m…\u001b[0m\u001b[38;2;235;111;146m│\u001b[0m\r\n 95 \u001b[0m\u001b[38;2;156;207;216m▏\u001b[0m\u001b[38;2;57;53;82m ▏ \u001b[0m\u001b[3m\u001b[38;2;156;207;216mtotal_space\u001b[0m \u001b[0m\u001b[38;2;144;140;170m=\u001b[0m \u001b[0m\u001b[38;2;246;193;119m\"\"\u001b[0m\u001b[38;2;144;140;170m, \u001b[0m\u001b[38;2;235;111;146m│\u001b[0m \u001b[0m\u001b[1m\u001b[38;2;110;106;134m \u001b[0m\u001b[1m\u001b[38;2;235;111;146m...t/.local/share/nvim/lazy/nu\u001b[0m\u001b[38;2;110;106;134m…\u001b[0m\u001b[38;2;235;111;146m│\u001b[0m\r\n 96 \u001b[0m\u001b[38;2;156;207;216m▏\u001b[0m\u001b[38;2;57;53;82m ▏ \u001b[0m\u001b[3m\u001b[38;2;156;207;216mused_space_percent\u001b[0m \u001b[0m\u001b[38;2;144;140;170m=\u001b[0m \u001b[0m\u001b[38;Line truncated "ansi": "\u001b[0m\u001b[38;5;167m┌─ album artists ───┐\u001b[0m\u001b[38;5;251m┌─ tracks (sorted by album) ───────────────────────────────────┐\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;0m\u001b[48;5;185mBon Iver \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│\u001b[0m\u001b[38;5;148m22, a Million - 34:10 \u001b[0m\u001b[7m\u001b[38;5;251m \u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251mBon Iver & Daniel..\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│\u001b[0m\u001b[38;5;0m\u001b[48;5;185m 1 22 (OVER S∞∞N)\u001b[0m\u001b[48;5;185m \u001b[0m\u001b[38;5;0m\u001b[48;5;185m2:48 Bon Iver \u001b[0m\u001b[38;5;251m│\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251mBon Iver & Dijon ..\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 2 10 d E A T h b R E a s T ⚄ ⚄ 2:24 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│ │\u001b[0m\u001b[38;5;251m│ 3 715 - CR∑∑KS 2:12 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 4 33 “GOD” 3:33 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 5 29 #Strafford APTS 4:05 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 6 666 ʇ 4:12 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 7 21 M◊◊N WATER 3:08 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 8 8 (circle) 5:09 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 9 ____45_____ 2:46 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│ │\u001b[0m\u001b[38;5;251m│ 10 00000 Million 3:53 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│\u001b[0m\u001b[38;5;148mBon Iver, Bon Iver - 39:30 \u001b[0m\u001b[38;5;251m│\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 1 Perth 4:22 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 2 Minnesota, WI 3:53 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 3 Holocene 5:37 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│ │\u001b[0m\u001b[38;5;251m│ 4 Towers 3:08 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 5 Michicant 3:46 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 6 Hinnom, TX 2:45 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│ │\u001b[0m\u001b[38;5;251m│ 7 Wash. 4:59 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 8 Calgary 4:10 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 9 Lisbon, OH 1:33 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│ 10 Beth/Rest 5:17 Bon Iver │\u001b[0m\r\n\u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m \u001b[0m\u001b[38;5;167m│\u001b[0m\u001b[38;5;251m│\u001b[0m\Line truncated
"lines": 33
},
"5": {
"ansi": "\u001b[0m\u001b[38;5;6m~/.abook\u001b[0m\r\n\u001b[0m\u001b[38;5;7m╭───────────────┬──────────────────────────┬────────────────────────────────────────╮\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m\u001b[0m\u001b[7m\u001b[38;5;4m .abook \u001b[0m\u001b[38;5;4m\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[0m\u001b[7m addressbook \u001b[0m\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4mMetadata \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.agents \u001b[0m\u001b[38;5;7m│ \u001b[0m\u001b[38;2;255;255;255m \u001b[0maddressbook~ \u001b[0m\u001b[38;5;7m│\u001b[0m File: \u001b[0m\u001b[38;5;4maddressbook \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.ansible \u001b[0m\u001b[38;5;7m│ │\u001b[0m Mimetype: \u001b[0m\u001b[38;5;4mapplication/octet-stream \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.aspnet \u001b[0m\u001b[38;5;7m│ │\u001b[0m Location: \u001b[0m\u001b[38;5;4m/home/liph/.abook \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.atuin \u001b[0m\u001b[38;5;7m│ │\u001b[0m Mode: \u001b[0m\u001b[38;5;4m-rw-r--r-- \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.bun \u001b[0m\u001b[38;5;7m│ │\u001b[0m Attributes: \u001b[0m\u001b[38;5;4m---------------------- \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.cache \u001b[0m\u001b[38;5;7m│ │\u001b[0m Links: \u001b[0m\u001b[38;5;4m1 \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.calcurse \u001b[0m\u001b[38;5;7m│ │\u001b[0m Owner: \u001b[0m\u001b[38;5;4mliph/liph \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.cargo \u001b[0m\u001b[38;5;7m│ │\u001b[0m Size: \u001b[0m\u001b[38;5;4m89.9K \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.claude \u001b[0m\u001b[38;5;7m│ │\u001b[0m Created: \u001b[0m\u001b[38;5;4m2026-08-24 16:28 \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;255;152;0m \u001b[0m\u001b[38;5;4m.config \u001b[0m\u001b[38;5;7m│ │\u001b[0m Modified: \u001b[0m\u001b[38;5;4m2026-08-24 16:28 \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.dotnet \u001b[0m\u001b[38;5;7m│ │\u001b[0m Accessed: \u001b[0m\u001b[38;5;4m2026-08-24 16:28 \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.electron-g… \u001b[0m\u001b[38;5;7m│ │\u001b[0m Filesystem: \u001b[0m\u001b[38;5;4m/home \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.Garmin \u001b[0m\u001b[38;5;7m│ │\u001b[0m Device: \u001b[0m\u001b[38;5;4m/dev/sda2 \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.gnupg \u001b[0m\u001b[38;5;7m│ │\u001b[0m Type: \u001b[0m\u001b[38;5;4mbtrfs \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4m.herdr \u001b[0m\u001b[38;5;7m│ │\u001b[0m Free space: \u001b[0m\u001b[38;5;4mLine truncated
"lines": 35 "lines": 35
},
"9": {
"ansi": "\u001b[0m\u001b[38;5;5march liph \u001b[0m\u001b[38;5;4m~\u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯\u001b[0m ",
"lines": 2
} }
} }
}, },
{ {
"panes": { "panes": {
"6": { "11": {
"ansi": "\u001b[0m\u001b[48;2;35;33;54m phil spam proton \u001b[0m\u001b[1m\u001b[38;2;234;154;151m\u001b[48;2;35;33;54m Complete code challenge \u001b[0m\u001b[48;2;35;33;54m \u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;2;196;167;231mFrom:\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m Ollama <no-reply@mail.ollama.com> \u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;2;196;167;231mTo:\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m <phil@liphlink.xyz> \u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;2;196;167;231mSubject:\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m Complete code challenge \u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;2;196;167;231mDate:\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m 2026 Aug 24, 16:27 GMT+0200 \u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────\u001b[0m\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\u001b[0m\u001b[38;2;224;222;244mComplete code challenge\u001b[0m Line truncated "ansi": "\u001b[0m\u001b[1m\u001b[38;2;234;154;151m\u001b[48;2;35;33;54m phil \u001b[0m\u001b[48;2;35;33;54m spam proton \u001b[0m\r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m+Action 0\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m O Jenny Quénard <jenny@jennyquenard.com> Ice Baths @ Heal Play Love // Your gifts as promised :) 12:50\u001b[0m\u001b[38;2;35;33;54m\u001b[48;2;110;106;134m \u001b[0m\r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54mArchive 424 / 561\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m O Ollama <hello@ollama.com> GLM 5.3 & 5.3 Flash models are now available 03:30\u001b[0m\u001b[38;2;35;33;54m\u001b[48;2;110;106;134m \u001b[0m\r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m+Community 0\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[38;2;110;106;134m\u001b[48;2;42;39;63m Ollama <no-reply@mail.ollama.com> Complete code challenge Aug 28\u001b[0m\u001b[38;2;35;33;54m\u001b[48;2;110;106;134m \u001b[0m\r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54mEverything 594 / 929\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m Oa Noah Zollinger <info@noahzollinger.com> [This full moon] The power of the group field Aug 27\u001b[0m\u001b[38;2;35;33;54m\u001b[48;2;110;106;134m \u001b[0m\r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54mFinance 0\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m O Megan Ashton <meganashton@gmail.com> Your Friendly Tuition Reminder 🐖 Aug 27\u001b[0m\u001b[38;2;35;33;54m\u001b[48;2;110;106;134m \u001b[0m\r\n\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;234;154;151mInbox 149 / 305\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m O Ollama <hello@ollama.com> Ollama weekly usage at 90% Aug 27\u001b[0m \r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m+Mail 0\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m O Ollama <hello@ollama.com> Claude Desktop support with Ollama Aug 26\u001b[0m \r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54mNewsletters 0\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m O TCS Camping <camping@camping-news.tcs.ch> Wo geht Ihr nächstes Camping-Abenteuer hin? ⛺ Aug 26\u001b[0m \r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m+Priority 0\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m O Ollama <no-reply@mail.ollama.com> Complete code challenge Aug 26\u001b[0m \r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54mStarred 1\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[38;2;110;106;134m\u001b[48;2;42;39;63m Ollama <hello@ollama.com> Ollama session usage at 90% Aug 26\u001b[0m \r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54m+Time 0\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;224;222;244m\u001b[48;2;42;39;63m O Ollama <hello@ollama.com> Ollama session usage at 90% Aug 25\u001b[0m \r\n\u001b[0m\u001b[38;2;156;207;216m\u001b[48;2;35;33;54mUnread 573 / 573\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;35;33;54m│\u001b[0m\u001b[1m\u001b[38;2;35;33;54m\u001b[48;2;234;154;151m Ollama <no-reply@mail.ollama.com> Complete code challenge Aug 24\u001b[0m \r\n\u001b[0m\u001b[38;2;156;Line truncated
"lines": 39 "lines": 37
} }
} }
} }
@@ -41,9 +41,13 @@
"tabs": [ "tabs": [
{ {
"panes": { "panes": {
"7": { "12": {
"ansi": "yazi\r\n\u001b[0m\u001b[38;5;5m❯ \u001b[0m\u001b[38;5;2myazi\u001b[0m\r\n\r\n\u001b[0m\u001b[38;5;5march liph \u001b[0m\u001b[38;5;4m~/dotfiles\u001b[0m\u001b[38;5;3m main* \u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯\u001b[0m \u001b[0m\u001b[1m\u001b[7m%\u001b[0m \u001b[0m\u001b[38;5;5march liph \u001b[0m\u001b[38;5;4m~/dotfiles\u001b[0m\u001b[38;5;3m main* \u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯\u001b[0m \u001b[0m\u001b[1m\u001b[7m%\u001b[0m \u001b[0m\u001b[38;5;5march liph \u001b[0m\u001b[38;5;4m~/dotfiles\u001b[0m\u001b[38;5;3m main* \u001b[0m\r\n\u001b[0m\u001b[38;5;5m❯\u001b[0m ", "ansi": "\u001b[0m\u001b[38;5;5march liph \u001b[0m\u001b[38;5;4m~/dotfiles \u001b[0m\u001b[38;5;3m main* \u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;158;158;158m \u001b[0m\u001b[38;5;4mautobook\u001b[0m\u001b[3m\u001b[38;5;4m -> /mnt\u001b[0m\u001b[38;5;4m… \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m\u001b[0m\u001b[7m\u001b[38;5;4m .crew \u001b[0m\u001b[38;5;4m\u001b[0m\u001b[38;5;7m│ \u001b[0mNo items\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mbak \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;0;188;212m \u001b[0m\u001b[38;5;4m.git \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;158;158;158m \u001b[0m\u001b[38;5;4mcloud\u001b[0m\u001b[3m\u001b[38;5;4m -> /mnt/ss\u001b[0m\u001b[38;5;4m… \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4maerc \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;158;158;158m \u001b[0m\u001b[38;5;4mcode\u001b[0m\u001b[3m\u001b[38;5;4m -> /mnt/fla\u001b[0m\u001b[38;5;4m… \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mansible \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;158;158;158m \u001b[0m\u001b[38;5;4mconsume_liph\u001b[0m\u001b[3m\u001b[38;5;4m -> \u001b[0m\u001b[38;5;4m… \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4matuin \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;0;188;212m \u001b[0m\u001b[38;5;4mDesktop \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mbackgrounds \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;0;188;212m \u001b[0m\u001b[38;5;4mDocuments \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mgarmin \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mdot_omerx \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mghostty \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m\u001b[0m\u001b[7m\u001b[38;5;4m dotfiles \u001b[0m\u001b[38;5;4m\u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mherdr \u001b[0m\u001b[38;5;3m \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;0;188;212m \u001b[0m\u001b[38;5;4mDownloads \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mherdr_1 \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mgarmin_device \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mhypr \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mgo \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mkanata \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mMail \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mkitty \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;0;188;212m \u001b[0m\u001b[38;5;4mMusic \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mniri \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mnetbox-docker \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mnushell \u001b[0m\u001b[38;5;7m│\u001b[0m\r\n \u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mparu \u001b[0m\u001b[38;5;7m│\u001b[0m\u001b[38;5;4m \u001b[0m\u001b[38;2;3;169;244m \u001b[0m\u001b[38;5;4mnvim Line truncated
"lines": 7 "lines": 35
},
"13": {
"ansi": "╭─[1]─Status─────────────────────────╮╮\r\n│\u001b[0m\u001b[38;5;2m✓ \u001b[0mdotfiles → main │▐\r\n╰────────────────────────────────────╯│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m╭─[2]─Files \u001b[0m- Worktrees - Submodules\u001b[0m\u001b[1m\u001b[38;5;2m─╮\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m\u001b[1m\u001b[38;5;10m\u001b[48;5;4m▼\u001b[0m\u001b[1m\u001b[48;5;4m \u001b[0m\u001b[1m\u001b[38;5;10m\u001b[48;5;4m/\u001b[0m\u001b[1m\u001b[48;5;4m \u001b[0m\u001b[1m\u001b[38;5;2m▐\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2m▼ ClipCascade \u001b[0m\u001b[1m\u001b[38;5;2m▐\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2mD LICENSE \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2m▼ cli \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2mD echo.py \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2mD info.py \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2mD login.py \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2mD message_box.py \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2mD tray.py \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2m▼ clipboard \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2mD clipboard_manager.py \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m│ \u001b[0m\u001b[38;5;2mD clipboard_monitor_linux.py \u001b[0m\u001b[1m\u001b[38;5;2m│\u001b[0m│\r\n\u001b[0m\u001b[1m\u001b[38;5;2m╰────────────────────────────1 of 75─╯\u001b[0m│\r\n╭─[3]─\u001b[0m\u001b[38;5;2mLocal branches \u001b[0m- Remotes - Tag─╮│\r\n│\u001b[0m\u001b[38;5;2m * \u001b[0mmain \u001b[0m\u001b[38;5;2m✓ \u001b[0m││\r\n│\u001b[0m\u001b[38;5;6m1M \u001b[0mtest (worktree) ││\r\n│ ││\r\n│ ││\r\n│ ││\r\n╰─────────────────────────────1 of 2─╯│\r\n╭─[4]─\u001b[0m\u001b[38;5;2mCommits \u001b[0m- Reflog───────────────╮│\r\n│\u001b[0m\u001b[38;5;2m4ff0615b \u001b[0m\u001b[38;2;221;12;75mli ○ \u001b[0mupdated yazi ▐│\r\n│\u001b[0m\u001b[38;5;2m81aa62d9 \u001b[0m\u001b[38;2;221;12;75mli ○ \u001b[0mupdated yazi config ││\r\n│\u001b[0m\u001b[38;5;2m6868bb0f \u001b[0m\u001b[38;2;221;12;75mli ○ \u001b[0mupdated yazi config ││\r\n│\u001b[0m\u001b[38;5;2ma8a1b5a7 \u001b[0m\u001b[38;2;221;12;75mli ○ \u001b[0mrestertet yazi setup ││\r\n│\u001b[0m\u001b[38;5;2md6fd64c8 \u001b[0m\u001b[38;2;221;12;75mli ○ \u001b[0madd lxc-update ││\r\n╰────────────────────────────1 of 70─╯╯\r\n╭─[5]─Stash──────────────────────────╮╮\r\n│\u001b[0m\u001b[38;5;6m23h \u001b[0mWIP on main: d6fd64c add lxc-upd││\r\n╰─────────────────────────────1 of 8─╯╯\r\n\u001b[0m\u001b[38;5;4mStage: <spac \u001b[0m\u001b[4m\u001b[38;5;5mDonate \u001b[0m\u001b[4m\u001b[38;5;3mAsk Question \u001b[0m0.63.0",
"lines": 35
} }
} }
} }
+69 -50
View File
@@ -2,17 +2,17 @@
"version": 3, "version": 3,
"workspaces": [ "workspaces": [
{ {
"id": "w2", "id": "w4",
"custom_name": "Home", "custom_name": "Home",
"identity_cwd": "/home/liph/dotfiles/yazi/.config/yazi", "identity_cwd": "/home",
"public_pane_numbers": { "public_pane_numbers": {
"3": 8, "8": 2,
"1": 2, "10": 4,
"5": 7, "7": 1,
"2": 5, "11": 5,
"6": 4 "9": 3
}, },
"next_public_pane_number": 9, "next_public_pane_number": 6,
"public_tab_numbers": [ "public_tab_numbers": [
1, 1,
2, 2,
@@ -25,26 +25,26 @@
"layout": { "layout": {
"Split": { "Split": {
"direction": "Horizontal", "direction": "Horizontal",
"ratio": 0.46022728, "ratio": 0.5,
"first": { "first": {
"Pane": 1 "Pane": 7
}, },
"second": { "second": {
"Pane": 2 "Pane": 8
} }
} }
}, },
"panes": { "panes": {
"1": { "7": {
"cwd": "/home/liph/dotfiles/yazi/.config/yazi" "cwd": "/home"
}, },
"2": { "8": {
"cwd": "/home/liph/Pictures" "cwd": "/home/liph/dotfiles/yazi/.config/yazi"
} }
}, },
"zoomed": false, "zoomed": false,
"focused": 1, "focused": 7,
"root_pane": 1 "root_pane": 7
}, },
{ {
"custom_name": "Music", "custom_name": "Music",
@@ -53,50 +53,51 @@
"direction": "Horizontal", "direction": "Horizontal",
"ratio": 0.5, "ratio": 0.5,
"first": { "first": {
"Pane": 3 "Pane": 9
}, },
"second": { "second": {
"Pane": 5 "Pane": 10
} }
} }
}, },
"panes": { "panes": {
"5": { "9": {
"cwd": "/home/liph/.abook" "cwd": "/home/liph"
}, },
"3": { "10": {
"cwd": "/home/liph/dotfiles/yazi/.config/yazi/plugins/file-extra-metadata.yazi"
}
},
"zoomed": false,
"focused": 3,
"root_pane": 3
},
{
"custom_name": "Aerc",
"layout": {
"Pane": 6
},
"panes": {
"6": {
"cwd": "/home/liph" "cwd": "/home/liph"
} }
}, },
"zoomed": false, "zoomed": false,
"focused": 6, "focused": 9,
"root_pane": 6 "root_pane": 9
}
],
"active_tab": 1
}, },
{ {
"id": "w3", "custom_name": "Aerc",
"layout": {
"Pane": 11
},
"panes": {
"11": {
"cwd": "/home/liph"
}
},
"zoomed": false,
"focused": 11,
"root_pane": 11
}
],
"active_tab": 0
},
{
"id": "w5",
"custom_name": "Dotfiles", "custom_name": "Dotfiles",
"identity_cwd": "/home/liph/dotfiles", "identity_cwd": "/home/liph/dotfiles",
"public_pane_numbers": { "public_pane_numbers": {
"7": 1 "13": 2,
"12": 1
}, },
"next_public_pane_number": 2, "next_public_pane_number": 3,
"public_tab_numbers": [ "public_tab_numbers": [
1 1
], ],
@@ -105,23 +106,41 @@
{ {
"custom_name": "Dotfiles", "custom_name": "Dotfiles",
"layout": { "layout": {
"Pane": 7 "Split": {
"direction": "Horizontal",
"ratio": 0.7613636,
"first": {
"Pane": 12
},
"second": {
"Pane": 13
}
}
}, },
"panes": { "panes": {
"7": { "13": {
"cwd": "/home/liph/dotfiles",
"label": "Git",
"launch_argv": [
"bash",
"-c",
"exec bash \"$HERDR_PLUGIN_ROOT/scripts/run-lazygit.sh\""
]
},
"12": {
"cwd": "/home/liph/dotfiles" "cwd": "/home/liph/dotfiles"
} }
}, },
"zoomed": false, "zoomed": false,
"focused": 7, "focused": 13,
"root_pane": 7 "root_pane": 12
} }
], ],
"active_tab": 0 "active_tab": 0
} }
], ],
"active": 0, "active": 1,
"selected": 0, "selected": 1,
"sidebar_width": 26, "sidebar_width": 26,
"sidebar_section_split": 0.5, "sidebar_section_split": 0.5,
"collapsed_space_keys": [] "collapsed_space_keys": []
+1 -25
View File
@@ -1,29 +1,5 @@
--- eza-preview --- --- eza-preview ---
require("eza-preview"):setup({ require("eza-preview"):setup({})
-- Set the tree preview to be default (default: true)
default_tree = true,
-- Directory depth level for tree preview (default: 3)
level = 3,
-- Show file icons
icons = true,
-- Follow symlinks when previewing directories (default: true)
follow_symlinks = true,
-- Show target file info instead of symlink info (default: false)
dereference = false,
-- Show hidden files (default: true)
all = true,
-- Ignore files matching patterns (default: {})
-- ignore_glob = "*.log"
-- ignore_glob = { "*.tmp", "node_modules", ".git", ".DS_Store" }
-- SEE: https://www.linuxjournal.com/content/pattern-matching-bash to learn about glob patterns
ignore_glob = {},
-- Ignore files mentioned in '.gitignore' (default: true)
git_ignore = true,
-- Show git status (default: false)
git_status = false,
})
-- -- Or use default settings
-- require("eza-preview"):setup({})
--- omp --- --- omp ---
require("omp"):setup({ config = "/home/liph/.config/yazi/omp/omp.toml" }) require("omp"):setup({ config = "/home/liph/.config/yazi/omp/omp.toml" })
+57
View File
@@ -7,6 +7,62 @@
# ~/.config/yazi/keymap.toml # ~/.config/yazi/keymap.toml
prepend_keymap = [ prepend_keymap = [
###############################################################################
### toggle-pane ###
###############################################################################
{ on = [
"m",
"1",
], run = "plugin toggle-pane min-parent", desc = "Show or hide the parent pane" },
{ on = [
"m",
"2",
], run = "plugin toggle-pane min-current", desc = "Show or hide the current pane" },
{ on = [
"m",
"3",
], run = "plugin toggle-pane min-preview", desc = "Show or hide the preview pane" },
{ on = [
"M",
"1",
], run = "plugin toggle-pane max-parent", desc = "Maximize or restore the parent pane" },
{ on = [
"M",
"2",
], run = "plugin toggle-pane max-current", desc = "Maximize or restore the current pane" },
{ on = [
"M",
"3",
], run = "plugin toggle-pane max-preview", desc = "Maximize or restore the preview pane" },
###############################################################################
### fast-piper ###
###############################################################################
{ on = [
"<A-Up>",
], run = "seek -1", desc = "Scroll up" },
{ on = [
"<A-Down>",
], run = "seek +1", desc = "Scroll down" },
{ on = [
"<S-Up>",
], run = "seek -10", desc = "Scroll up" },
{ on = [
"<S-Down>",
], run = "seek +10", desc = "Scroll down" },
###############################################################################
### smart-filter ###
###############################################################################
{ on = [
"D",
], run = "plugin smart-filter", desc = "Smart filter" },
###############################################################################
### wl-clipboard ###
###############################################################################
{ on = [
"<C-y>",
], run = [
"plugin wl-clipboard",
] },
############################################################################### ###############################################################################
### omni-trash ### ### omni-trash ###
############################################################################### ###############################################################################
@@ -72,6 +128,7 @@ prepend_keymap = [
############################################################################### ###############################################################################
{ on = [ { on = [
"M", "M",
"M",
], run = "plugin lsblk-mount", desc = "Open the drive mount manager" }, ], run = "plugin lsblk-mount", desc = "Open the drive mount manager" },
############################################################################### ###############################################################################
### chmod ### ### chmod ###
+20 -5
View File
@@ -73,15 +73,30 @@ use = "boydaihungst/file-extra-metadata"
rev = "8bb639d" rev = "8bb639d"
hash = "8c5f14c09c981a496afaab5184e4aa08" hash = "8c5f14c09c981a496afaab5184e4aa08"
[[plugin.deps]]
use = "Sonico98/exifaudio"
rev = "4506f9d"
hash = "4761fffb60a12d37096c34a356380cdf"
[[plugin.deps]] [[plugin.deps]]
use = "goon/omni-trash" use = "goon/omni-trash"
rev = "3c2a992" rev = "3c2a992"
hash = "6e5bf967707c8c9b6495cf5863ff497f" hash = "6e5bf967707c8c9b6495cf5863ff497f"
[[plugin.deps]]
use = "grappas/wl-clipboard"
rev = "8cc5524"
hash = "5c587834c274dca9059092714ece1f18"
[[plugin.deps]]
use = "yazi-rs/plugins:smart-filter"
rev = "c591a36"
hash = "d6f7351ea25a43c9b5f4315fa1e23935"
[[plugin.deps]]
use = "alberti42/faster-piper"
rev = "bb90261"
hash = "12b5e342d54db42b5b023faa1a11f28e"
[[plugin.deps]]
use = "yazi-rs/plugins:toggle-pane"
rev = "c591a36"
hash = "5b2fbef7d1513ce38ff72623a071a5e"
[flavor] [flavor]
deps = [] deps = []
@@ -1,38 +0,0 @@
# exifaudio.yazi
Preview audio metadata and cover on [Yazi](https://github.com/sxyazi/yazi).
![image](https://github.com/Sonico98/exifaudio.yazi/assets/61394886/53c1492c-9f05-4c80-a4e7-94fb36f35ca9)
## Installation
```sh
# Automatically with yazi 0.3.0
ya pack -a "Sonico98/exifaudio"
# Or manually under:
# Linux/macOS
git clone https://github.com/Sonico98/exifaudio.yazi.git ~/.config/yazi/plugins/exifaudio.yazi
# Windows
git clone https://github.com/Sonico98/exifaudio.yazi.git %AppData%\yazi\config\plugins\exifaudio.yazi
```
## Usage
Add the following to your `yazi.toml`:
```toml
[plugin]
prepend_previewers = [
{ mime = "audio/*", run = "exifaudio"}
]
```
Make sure you have [exiftool](https://exiftool.org/) installed and in your `PATH`.
Optional: if you have [mediainfo](https://mediaarea.net/en/MediaInfo) installed and in your `PATH`, it will be used instead for more accurate metadata. Exiftool is still required to display the cover.
## Thanks
Thanks to [sxyazi](https://github.com/sxyazi) for the PDF previewer code, on which this previewer is based on.
@@ -1,215 +0,0 @@
local M = {}
function GetPath(str)
local sep = '/'
if ya.target_family() == "windows" then
sep = '\\'
end
return str:match("(.*"..sep..")")
end
function Exiftool(...)
local child = Command("exiftool")
:arg{
"-q", "-q", "-S", "-Title", "-SortName",
"-TitleSort", "-TitleSortOrder", "-Artist",
"-SortArtist", "-ArtistSort", "-PerformerSortOrder",
"-Album", "-SortAlbum", "-AlbumSort", "-AlbumSortOrder",
"-AlbumArtist", "-SortAlbumArtist", "-AlbumArtistSort",
"-AlbumArtistSortOrder", "-Genre", "-TrackNumber",
"-Year", "-Duration", "-SampleRate",
"-AudioSampleRate", "-AudioBitrate", "-AvgBitrate",
"-Channels", "-AudioChannels", tostring(...),
}
:stdout(Command.PIPED)
:stderr(Command.NULL)
:spawn()
return child
end
function Mediainfo(...)
local file, cache_dir = ...
local template = cache_dir.."mediainfo.txt"
local child = Command("mediainfo")
:arg{
"--Output=file://"..template, tostring(file)
}
:stdout(Command.PIPED)
:stderr(Command.NULL)
:spawn()
return child
end
function M:peek(job)
local cache = ya.file_cache(job)
if not cache then
return
end
-- Get cache dir to find the mediainfo template file
local cache_dir = GetPath(tostring(cache))
-- Try mediainfo, otherwise use exiftool
local status, child = pcall(Mediainfo, job.file.url, cache_dir)
if not status or child == nil then
status, child = pcall(Exiftool, job.file.url)
if not status or child == nil then
local error = ui.Line { ui.Span("Make sure exiftool is installed and in your PATH") }
local p = ui.Text(error):area(job.area):wrap(ui.Wrap.YES)
ya.preview_widget(job, { p })
return
end
end
local limit = job.area.h
local i, metadata = 0, {}
repeat
local next, event = child:read_line()
if event == 1 then
return self:fallback_to_builtin()
elseif event ~= 0 then
break
end
i = i + 1
if i > job.skip then
local m_title, m_tag = Prettify(next)
if m_title ~= "" and m_tag ~= "" then
local ti = ui.Span(m_title):bold()
local ta = ui.Span(m_tag)
table.insert(metadata, ui.Line{ti, ta})
table.insert(metadata, ui.Line{})
end
end
until i >= job.skip + limit
local p = ui.Text(metadata):area(job.area):wrap(ui.Wrap.YES)
ya.preview_widget(job, { p })
local cover_width = job.area.w / 2 - 5
local cover_height = (job.area.h / 4) + 3
local bottom_right = ui.Rect {
x = job.area.right - cover_width,
y = job.area.bottom - cover_height,
w = cover_width,
h = cover_height,
}
if self:preload(job) == true then
ya.image_show(cache, bottom_right)
end
end
function Prettify(metadata)
local substitutions = {
Sortname = "Sort Title:",
SortName = "Sort Title:",
TitleSort = "Sort Title:",
TitleSortOrder = "Sort Title:",
ArtistSort = "Sort Artist:",
SortArtist = "Sort Artist:",
Artist = "Artist:",
ARTIST = "Artist:",
PerformerSortOrder = "Sort Artist:",
SortAlbumArtist = "Sort Album Artist:",
AlbumArtistSortOrder = "Sort Album Artist:",
AlbumArtistSort = "Sort Album Artist:",
AlbumSortOrder = "Sort Album:",
AlbumSort = "Sort Album:",
SortAlbum = "Sort Album:",
Album = "Album:",
ALBUM = "Album:",
AlbumArtist = "Album Artist:",
Genre = "Genre:",
GENRE = "Genre:",
TrackNumber = "Track Number:",
Year = "Year:",
Duration = "Duration:",
AudioBitrate = "Bitrate:",
AvgBitrate = "Average Bitrate:",
AudioSampleRate = "Sample Rate:",
SampleRate = "Sample Rate:",
AudioChannels = "Channels:"
}
for k, v in pairs(substitutions) do
metadata = metadata:gsub(tostring(k)..":", v, 1)
end
-- Separate the tag title from the tag data
local t={}
for str in string.gmatch(metadata , "([^"..":".."]+)") do
if str ~= "\n" then
table.insert(t, str)
else
table.insert(t, nil)
end
end
-- Add back semicolon to title, rejoin tag data if it happened to contain a semicolon
local title, tag_data = "", ""
if t[1] ~= nil then
title, tag_data = t[1]..":", table.concat(t, ":", 2)
end
return title, tag_data
end
function M:seek(job)
local h = cx.active.current.hovered
if h and h.url == job.file.url then
ya.manager_emit("peek", {
tostring(math.max(0, cx.active.preview.skip + job.units)),
only_if = tostring(job.file.url),
})
end
end
function M:preload(job)
local cache = ya.file_cache(job)
if not cache or fs.cha(cache) then
return true
end
local mediainfo_template = 'General;"\
$if(%Track%,Title: %Track%,)\
$if(%Track/Sort%,Sort Title: %Track/Sort%,)\
$if(%Title/Sort%,Sort Title: %Title/Sort%,)\
$if(%TITLESORT%,Sort Title: %TITLESORT%,)\
$if(%Performer%,Artist: %Performer%,)\
$if(%Performer/Sort%,Sort Artist: %Performer/Sort%,)\
$if(%ARTISTSORT%,Sort Artist: %ARTISTSORT%,)\
$if(%Album%,Album: %Album%,)\
$if(%Album/Sort%,Sort Album: %Album/Sort%)\
$if(%ALBUMSORT%,Sort Album: %ALBUMSORT%)\
$if(%Album/Performer%,Album Artist: %Album/Performer%)\
$if(%Album/Performer/Sort%,Sort Album Artist: %Album/Performer/Sort%)\
$if(%Genre%,Genre: %Genre%)\
$if(%Track/Position%,Track Number: %Track/Position%)\
$if(%Recorded_Date%,Year: %Recorded_Date%)\
$if(%Duration/String%,Duration: %Duration/String%)\
$if(%BitRate/String%,Bitrate: %BitRate/String%)\
"\
Audio;"Sample Rate: %SamplingRate%\
Channels: %Channel(s)%"\
'
-- Write the mediainfo template file into yazi's cache dir
local cache_dir = GetPath(tostring(cache))
fs.write(Url(cache_dir.."mediainfo.txt"), mediainfo_template)
local output = Command("exiftool")
:arg{ "-b", "-CoverArt", "-Picture", tostring(job.file.url) }
:stdout(Command.PIPED)
:stderr(Command.PIPED)
:output()
if not output then
return true, Err("Couldn't extract cover art, error: %s", err)
end
return fs.write(cache, output.stdout) and true or false
end
return M
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2026 Andrea Alberti
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.
@@ -0,0 +1,279 @@
# faster-piper.yazi
A fast, cache-aware reimplementation of `piper.yazi` for Yazi.
`faster-piper` is a general-purpose previewer that pipes the output of an
arbitrary shell command into Yazi’s preview pane, with aggressive caching
and efficient scrolling for large outputs.
## Installation
**Requires Yazi 26.8.15 or newer.** Earlier versions lack the `th.icon:match` and
`Url.spec.is_search` APIs this plugin uses, and Yazi will refuse to load it with a
prompt to upgrade. If you cannot upgrade Yazi, use
[`piper.yazi`](https://github.com/yazi-rs/plugins/tree/main/piper.yazi) instead.
```sh
ya pkg add alberti42/faster-piper
```
### Windows
**Windows is untested.** The plugin is developed on macOS and Linux, and
nobody has yet confirmed a working preview on Windows. Several
Windows-specific defects have been fixed by inspection rather than by
running the plugin there, so treat the platform as unsupported until a user
reports otherwise.
What is expected to be required:
Like `piper.yazi`, this plugin runs your command through a POSIX shell, so a
`sh` must be reachable on `PATH`, for instance from
[MSYS2](https://www.msys2.org), Cygwin, or Git for Windows. Note that a default
Git for Windows installation puts only `C:\Program Files\Git\cmd` on `PATH`,
which contains no `sh.exe`; enable *Use Git and optional Unix tools from the
Command Prompt* at install time, or add `C:\Program Files\Git\usr\bin`
yourself. Preview recipes are POSIX shell, not `cmd`, on every platform.
Please report your experience, working or not, in
[issue #2](https://github.com/alberti42/faster-piper.yazi/issues/2), which
collects everything Windows-related. A confirmation that previews render
correctly is very valuable: once it is confirm correct Windows behavior, a new
release will be made announcing the Windows support.
## Motivation
The original [`piper.yazi`](https://github.com/yazi-rs/plugins/tree/main/piper.yazi)
is a simple and elegant previewer that executes a shell command on each preview.
`faster-piper` started as an experiment to explore whether:
- preview output could be cached safely,
- scrolling could be made O(1) using file-backed paging,
- large outputs could be handled without re-running the generator,
- resizing and jump-to-end behavior could be made deterministic.
The result is a substantially different internal architecture that favors
performance and predictability for expensive preview commands.
## Compatibility with `piper.yazi`
`faster-piper` is **syntax-compatible** with `piper.yazi`.
Existing configurations written for `piper.yazi` continue to work without
modification. The command format, variables, and preview semantics are the same:
- `$1` — path to the file being previewed, always written as `"$1"` with the
double quotes; the quoted form is what gets replaced by the escaped path
- `$w` — preview width
- `$h` — preview height
- `$t` — detected terminal theme, either `dark` or `light`
`$t` comes from Yazi's own terminal detection, so previews match the rest of the
interface. If your terminal does not report a colour scheme, `$t` is `dark`.
You can replace `piper` with `faster-piper` in your Yazi configuration and keep
using the same preview commands.
For more usage examples and ideas, please refer to the original
[`piper.yazi` README](https://github.com/yazi-rs/plugins/tree/main/piper).
## Caching
A preview is generated once and reused. The cache is discarded when the file
changes, when you edit the command in `yazi.toml`, and when one of `$w`, `$h` or
`$t` changes — but each of those only if your command actually reads it.
So resizing the preview pane regenerates a `glow -w=$w` preview, and leaves a
`tar -tf "$1"` preview alone, because the second produces the same output at any
size.
> **Note**
> faster-piper can only see the theme through `$t`. If your command detects the
> theme by itself — for example `bat --theme=auto:always` — faster-piper cannot
> know that its output depends on the theme, and the cache will not refresh when
> you switch. Use `$t` instead.
## Usage
### Configure previewers
Use `faster-piper` exactly like `piper`: pass a shell command after `--`.
The command’s stdout becomes the preview content.
#### Example: Preview Markdown with `glow`
```toml
[[plugin.prepend_previewers]]
url = "*.md"
run = 'faster-piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dracula -- "$1"'
```
#### Example: Match the terminal theme with `bat`
`bat` accepts `dark` and `light` as `--theme` values, which is exactly what `$t`
holds, so the two map onto each other directly:
```toml
[[plugin.prepend_previewers]]
url = "*.rs"
run = 'faster-piper -- bat -p --color=always --theme-dark=Dracula --theme-light=GitHub --theme="$t" "$1"'
```
Do not rely on `bat`'s own `--theme=auto` here. Preview output is redirected to
the cache file rather than to the terminal, so plain `auto` cannot detect
anything and falls back to a dark theme. `--theme=auto:always` does detect, but
it queries the terminal that Yazi is already reading from, and its result is
invisible to the cache. `$t` avoids both problems.
#### Example: Preview tarballs with `tar`
```toml
[[plugin.prepend_previewers]]
url = "*.tar*"
run = 'faster-piper --format=url -- tar tf "$1"'
```
### Preloading for instant previews
`faster-piper` works **without** preloading: the first `peek` will generate the
cache on demand.
If you want previews to appear _instantaneously_ when you move the cursor (i.e.
the cache is already warm by the time `peek` runs), configure a matching rule
under `plugin.prepend_preloaders`.
There are two supported ways to do this:
#### Option A (recommended): define the command only in the preloader with `--rely-on-preloader`
If you don’t want to duplicate the piping command in both places, you can make
the previewer rule “rely on the preloader”:
- The **preloader** is responsible for generating the cache (and therefore must
include the command after `--`).
- The **previewer** becomes a lightweight reader: it only displays the cache and
(in edge cases such as terminal resize) may self-heal using the cached recipe.
Example:
```toml
[plugin]
prepend_previewers = [
{ url = "*.md", run = 'faster-piper --rely-on-preloader' },
{ url = "*.tar*", run = 'faster-piper --rely-on-preloader --format=url' },
{ url = "*.txt.gz", run = 'faster-piper --rely-on-preloader' },
]
prepend_preloaders = [
{ url = "*.md", run = 'faster-piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dracula -- "$1"' },
{ url = "*.tar*", run = 'faster-piper -- tar tf "$1"' },
{ url = "*.txt.gz", run = 'faster-piper -- gzip -dc "$1"' },
]
```
This mode is mainly about **avoiding duplication**: you keep the generator
command in one place (the preloader rule), while the previewer rule stays a
lightweight cache reader.
Note: `faster-piper` is race-safe in both modes — if `preload` and `peek` happen
at the same time, a lock ensures only one process writes the cache, and the
other will reuse it once it becomes available.
##### Notes on `--rely-on-preloader`
- `--rely-on-preloader` is intended for setups where you **do configure**
`prepend_preloaders`. In that mode, `peek` will first assume the cache was
warmed by the preloader, and only falls back to self-healing in edge cases
(e.g. resize-triggered peeks).
- If you **don’t** use preloaders at all, omit the flag and run in normal mode:
`peek` will generate the cache on demand.
- When you _do_ use preloaders, `--rely-on-preloader` is the simplest way to
avoid keeping two command strings in sync.
- If you choose Option B (duplicating commands), keep them **identical**;
mixing different commands for the same matcher is undefined because of races.
#### Option B (classic): duplicate the same command in previewers + preloaders
This mirrors `piper.yazi` usage and is always valid.
```toml
[plugin]
prepend_previewers = [
{ url = "*.md", run = 'faster-piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dracula -- "$1"' },
{ url = "*.tar*", run = 'faster-piper --format=url -- tar tf "$1"' },
{ url = "*.txt.gz", run = 'faster-piper -- gzip -dc "$1"' },
]
prepend_preloaders = [
{ url = "*.md", run = 'faster-piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dracula -- "$1"' },
{ url = "*.tar*", run = 'faster-piper -- tar tf "$1"' },
{ url = "*.txt.gz", run = 'faster-piper -- gzip -dc "$1"' },
]
```
**Important:** the command templates must be identical. Yazi may race `preload`
and `peek`, and whichever runs first might win. If the commands differ, the cache
content becomes ambiguous.
##### Notes on race conditions (preloader vs. peek)
`faster-piper` handles the race between preloading and previewing gracefully:
- If both `preload` and `peek` arrive around the same time, **the generator is
not run twice** (the lock ensures only one writer).
- Which one “wins” (preloader or peek) can fluctuate depending on timing, but
the outcome is the same: you get a valid cache and a correct preview.
### Fast scrolling and “jump to top/bottom”
`faster-piper` supports normal incremental scrolling via `seek +/-N` (in lines).
In addition, it implements a _jump heuristic_ for very large seek steps:
- If a single `seek` step is **less than -999**, it jumps to the **top**.
- If a single `seek` step is **greater than +999**, it jumps to the **bottom**.
This is useful for binding keys like Home/End to instant top/bottom navigation,
without having to know the total line count ahead of time.
### Recommended keymaps
Add these to your `prepend_keymap` to enable smooth scrolling in the preview:
```toml
[plugin]
prepend_keymap = [
{ on = "<A-Up>", run = "seek -1", desc = "Scroll up" },
{ on = "<A-Down>", run = "seek +1", desc = "Scroll down" },
{ on = "<A-PageUp>", run = "seek -15", desc = "Scroll page up" },
{ on = "<A-PageDown>", run = "seek +15", desc = "Scroll page down" },
{ on = "<A-Home>", run = "seek -10000", desc = "Scroll to the top" },
{ on = "<A-End>", run = "seek +10000", desc = "Scroll to the bottom" },
]
```
Tip: if you prefer different thresholds, just keep the “jump” bindings beyond
±999 (e.g. ±5000, ±10000).
## Relationship to `piper.yazi`
This project is a **from-scratch rewrite** inspired by the original idea of
`piper.yazi`.
- The core concept (using shell commands as previewers) comes from
`piper.yazi`.
- The configuration syntax and user-facing behavior are intentionally kept
compatible.
- The internal implementation, caching model, and scrolling logic are new and
optimized for performance.
All credit for the original idea and initial implementation goes to the
`piper.yazi` authors.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
It is inspired by `piper.yazi`, which is also MIT-licensed.
See the LICENSE file for details.
@@ -0,0 +1,880 @@
--- @since 26.8.15
local M = {}
-- If Yazi asks for a skip larger than this, jump straight to the last page.
local SKIP_JUMP_THRESHOLD = 999
local PEEK_JUMP_THRESHOLD = 99999999
-- Maximum time allowed for preview (in ms)
local TIME_OUT_LOCK = 5000
local TIME_OUT_PREVIEW = 200
-- Maximum time for stale-lock directories
local LOCK_TTL_SEC = 60
----------------------------------------------------------------------
-- Cache header layout (1-based line numbers)
--
-- We keep ALL header-related offsets centralized here.
-- When adding a new header field:
-- 1) insert it into this layout
-- 2) bump HEADER.N
-- 3) bump HEADER.VERSION so existing caches are discarded
-- 4) update any reader functions that fetch header fields
----------------------------------------------------------------------
local HEADER = {
-- Layout marker, always stored on the FIRST line.
--
-- Bump this on ANY change to the layout below. A cache written by an
-- older version then fails validation, is removed, and is regenerated.
-- This is what makes header changes safe; there is no migration path.
--
-- It is NOT the plugin version, and must not follow it. A release that
-- leaves this layout untouched keeps the same marker, so caches stay
-- valid across upgrades. Bumping it needlessly discards every user's
-- cached preview for nothing.
VERSION = "FPCACHE1",
-- Total number of header lines stored at the top of the cache file.
N = 6,
-- Which header line contains what (1-based):
LINE_VER = 1, -- layout marker, must equal HEADER.VERSION
LINE_CMD = 2, -- raw user-provided command template (job.args[1], unchanged)
LINE_NLINE = 3, -- number of *content* lines (excludes headers)
LINE_W = 4, -- preview width used to generate this cache
LINE_H = 5, -- preview height used to generate this cache
LINE_T = 6, -- terminal theme used to generate this cache ("dark"|"light")
}
-- Content starts immediately after the header.
local function content_first_line()
return HEADER.N + 1
end
----------------------------------------------------------------------
-- Utils
----------------------------------------------------------------------
--- Parse a "truthy/falsey" value into a boolean, with an explicit default.
---
--- This is meant for plugin args / config values that might arrive as:
--- - nil -> returns `default`
--- - boolean -> returns that boolean
--- - number -> 0 = false, non-zero = true
--- - string -> common on/off values (case-insensitive):
--- true: "true", "1", "yes", "on"
--- false: "false", "0", "no", "off"
--- anything else -> returns `default`
--- - other types -> returns `default`
---
--- param v any -> Value to parse.
--- param default boolean -> The fallback value used when `v` is nil/unknown.
--- return boolean
local function is_true(v, default)
assert(type(default) == "boolean", "is_true: default must be a boolean")
if v == nil then
return default
end
if v == true then
return true
end
if v == false then
return false
end
if type(v) == "number" then
return v ~= 0
end
if type(v) == "string" then
v = v:lower()
if v == "true" or v == "1" or v == "yes" or v == "on" then
return true
end
if v == "false" or v == "0" or v == "no" or v == "off" then
return false
end
-- Unknown string: fall back to default (or you can choose to return true)
return default
end
-- Unknown type: fall back to default
return default
end
----------------------------------------------------------------------
-- fs_path(url) -> string
--
-- Convert Yazi Url into a real filesystem path string for external tools.
--
-- Why:
-- In some views (notably search results), Yazi uses virtual URLs such as:
-- search://dupli:1:1//Users/andrea/file.txt
-- External commands (bat, glow, tar, etc.) expect a plain filesystem path.
--
-- How:
-- Yazi already exposes the underlying path via `url.path`, and also tells
-- us whether this Url comes from search using `url.spec.is_search`.
--
-- Behavior:
-- - For search URLs: return tostring(url.path)
-- - For regular file URLs: return tostring(url)
-- - Defensive fallback: if url.path is missing/empty, fall back to tostring(url)
----------------------------------------------------------------------
local function fs_path(url)
if url and url.spec.is_search then
local p = url.path
if p then
local s = tostring(p)
if s ~= "" then
return s
end
end
end
return tostring(url)
end
-- Split text into "lines" (like read_line()).
-- Drops empty / whitespace-only lines to avoid blank entries.
local function split_lines(s)
local t = {}
if not s or s == "" then
return t
end
-- Ensure the last line is captured even if s doesn't end with '\n'
s = s .. "\n"
for line in s:gmatch("(.-)\n") do
-- Remove empty and whitespace-only lines:
-- - empty: line == ""
-- - whitespace-only: line:match("^%s*$")
if not line:match("^%s*$") then
t[#t + 1] = line .. "\n"
end
end
return t
end
----------------------------------------------------------------------
-- read_line_range(path, first, last) -> lines, err
--
-- Return lines [first, last] (1-based, inclusive) of a text file as a
-- table of strings, each WITHOUT its trailing newline. A trailing \r is
-- dropped too, so a cache written through a Windows shell parses exactly
-- like one written under Unix.
--
-- This replaces `sed -n '<first>,<last>p'`. Yazi also runs on Windows,
-- where `sed` is absent from the default PATH even when a POSIX shell is
-- installed (Git for Windows keeps it in usr\bin, off PATH). For the few
-- lines we need, spawning a process per peek costs more than reading the
-- file here anyway.
----------------------------------------------------------------------
local function read_line_range(path, first, last)
local fh, err = io.open(path, "r")
if not fh then
return nil, tostring(err)
end
local out, i = {}, 0
for line in fh:lines() do
i = i + 1
if i >= first then
out[#out + 1] = (line:gsub("\r$", ""))
end
if i >= last then
break
end
end
fh:close()
return out, nil
end
function M.format(job, lines)
local format = job.args.format
if format ~= "url" then
local s = table.concat(lines, ""):gsub("\r", ""):gsub("\t", string.rep(" ", rt.preview.tab_size))
return ui.Text.parse(s):area(job.area)
end
for i = 1, #lines do
lines[i] = lines[i]:gsub("[\r\n]+$", "")
local icon = th.icon:match(File {
url = Url(lines[i]),
cha = Cha { mode = tonumber(lines[i]:sub(-1) == "/" and "40700" or "100644", 8) },
})
if icon then
lines[i] = ui.Line { ui.Span(" " .. icon.text .. " "):style(icon.style), lines[i] }
end
end
return ui.Text(lines):area(job.area)
end
local read_cache_header -- forward declaration
----------------------------------------------------------------------
-- Terminal theme, as exposed to preview commands via $t.
--
-- rt.term.light() returns nil when the terminal does not report a
-- colour scheme. We treat that as "dark", which matches Yazi's own
-- default appearance. The fallback is deliberate and documented in the
-- README, because a user on an unreporting light terminal has no other
-- way to explain the result.
----------------------------------------------------------------------
local function current_theme()
return rt.term.light() and "light" or "dark"
end
----------------------------------------------------------------------
-- Does `tpl` read the environment variable `name`?
--
-- Matches "$name" and "${name}". The frontier pattern stops "$t" from
-- matching inside "$theme".
--
-- Over-matching is harmless: "$t" inside single quotes, or escaped as
-- "\$t", costs one extra cache rebuild. Under-matching would leave a
-- stale cache, so the check errs toward rebuilding.
----------------------------------------------------------------------
local function uses_env(tpl, name)
if tpl:find("${" .. name .. "}", 1, true) then
return true
end
return tpl:find("%$" .. name .. "%f[^%w_]") ~= nil
end
-- Header-based freshness check:
-- - cache mtime >= source mtime
-- - header parses and carries the current layout version
-- - header recipe matches the requested one, IF Yazi passed one
-- - header w/h/theme match the current ones, EACH only if the recipe
-- reads the matching variable ($w, $h, $t)
-- Returns:
-- ok, hdr
-- where hdr is the parsed header if available.
local function cache_is_fresh(job, cache_path)
local c = fs.cha(cache_path)
local s = job.file.cha
if not (c and c.mtime and s and s.mtime and c.mtime >= s.mtime) then
return false, nil
end
local hdr = read_cache_header(cache_path)
if not hdr then
return false, nil
end
-- The recipe is part of the cache identity: output produced by a
-- different command is not a cache hit.
--
-- Yazi omits the previewer arguments on some calls, e.g. seek. We
-- cannot compare then, and generate_cache recovers the stored recipe.
local tpl = job.args and job.args[1]
if tpl and tpl ~= "" and tpl ~= hdr.cmd then
return false, nil
end
-- Below, only the variables the recipe actually reads can affect its
-- output, so only those invalidate the cache. A recipe that ignores
-- $w produces identical bytes at any width; discarding its cache on
-- every resize would be pure waste.
--
-- This assumes the command learns the geometry and the theme from us,
-- not by inspecting the terminal itself. That holds here, because
-- stdout is redirected to the cache file and stdin is closed, so a
-- command sees a pipe rather than a terminal.
--
-- Caveat: a command that detects the theme through its own channel
-- (e.g. `bat --theme=auto:always`) defeats the $t test, and its cache
-- will not refresh. See the README.
if uses_env(hdr.cmd, "w") and hdr.w ~= job.area.w then
return false, nil
end
if uses_env(hdr.cmd, "h") and hdr.h ~= job.area.h then
return false, nil
end
if uses_env(hdr.cmd, "t") and hdr.t ~= current_theme() then
return false, nil
end
return true, hdr
end
-- Derive cache path from file_cache base + current w/h
local function get_cache_path(job)
local base = ya.file_cache({ file = job.file, skip = 0 })
if not base then
return nil, "caching-disabled-by-yazi"
end
return Url(tostring(base)), nil
end
-- Identify this Yazi instance. Used to keep the lock and the scratch
-- files of two instances previewing the same file apart.
local function instance_id()
local app_id = ya.id and ya.id("app") or nil
if app_id and app_id.value then
return tostring(app_id.value)
end
return "noid"
end
local function lock_path_for(cache_path)
-- faster-piper lock system
return Url(string.format("%s_FP_%s.lock", tostring(cache_path), instance_id()))
end
----------------------------------------------------------------------
-- Scratch files used while generating one cache entry.
--
-- They are named per instance and per cache entry, so two generators
-- racing for the same preview (different instances, or a lock that was
-- broken as stale) never write the same scratch path. The finished file
-- appears at cache_path through a single rename, so a reader sees either
-- the previous cache or the new one, never a half-written mixture.
----------------------------------------------------------------------
local function scratch_paths_for(cache_path)
local base = string.format("%s_FP_%s", tostring(cache_path), instance_id())
return Url(base .. ".out"), Url(base .. ".hdr")
end
local function lock_is_held(cache_path)
local lock = lock_path_for(cache_path)
return fs.cha(lock) ~= nil
end
-- Wait until cache is safe to read: unlocked + fresh.
-- Returns: ok, hdr
local function wait_for_ready_cache(job, cache_path, timeout_ms)
local deadline = ya.time() + (timeout_ms / 1000)
while ya.time() < deadline do
-- If writer is active, don't even try to read.
if lock_is_held(cache_path) then
ya.sleep(0.02) -- 20ms when locked
else
if not fs.cha(cache_path) then
ya.sleep(0.01)
else
local ok, hdr = cache_is_fresh(job, cache_path)
if ok then return true, hdr end
ya.sleep(0.01)
end
end
end
return false, nil
end
local function lock_age_seconds(lock_path)
local c = fs.cha(lock_path)
if not (c and c.mtime) then
return math.huge
end
return ya.time() - c.mtime
end
local function break_lock_dir(lock_path)
-- best-effort; ignore failures
fs.remove("dir_all", lock_path)
end
-- Try to acquire lock by creating a directory (atomic on POSIX filesystems).
-- Returns true if acquired, false if timed out.
local function acquire_lock(lock_path, timeout_ms)
timeout_ms = timeout_ms or 500
local deadline = ya.time() + (timeout_ms / 1000)
while ya.time() < deadline do
local ok = fs.create("dir", lock_path)
if ok then
return true
end
-- If it exists and is stale, break it and retry immediately
if lock_age_seconds(lock_path) > LOCK_TTL_SEC then
-- ya.dbg({ stale_lock = tostring(lock_path), age = lock_age_seconds(lock_path) })
break_lock_dir(lock_path)
else
ya.sleep(0.01)
end
end
return false
end
----------------------------------------------------------------------
-- Release a held lock, synchronously.
--
-- This deliberately avoids fs.remove(): that is an async Yazi API, and
-- the release must also work from a to-be-closed handler, where the
-- coroutine can no longer yield ("attempt to yield across a C-call
-- boundary"). os.remove() is plain C and removes an empty directory on
-- POSIX. On Windows it refuses directories, so an abandoned lock there
-- still has to wait for LOCK_TTL_SEC; nothing else breaks.
----------------------------------------------------------------------
local function release_lock(lock_path)
os.remove(tostring(lock_path))
end
----------------------------------------------------------------------
-- Read and validate a full header in ONE call.
-- Returns:
-- hdr = { cmd = <string>, nline = <number>, w = <number> } on success
-- nil, err on failure
--
-- Notes:
-- - cmd is returned without trailing newline.
-- - nline and w are parsed as integers.
----------------------------------------------------------------------
read_cache_header = function(cache_path)
-- Read the first HEADER.N lines at once
local lines, err = read_line_range(tostring(cache_path), 1, HEADER.N)
if not lines then
return nil, err
end
if #lines < HEADER.N then
return nil, "incomplete cache header (need " .. HEADER.N .. " lines, got " .. #lines .. ")"
end
-- Check the layout marker BEFORE anything else. A cache written by an
-- older version has a different layout, so every offset below is wrong
-- for it. Rejecting here makes the caller discard and regenerate it.
if lines[HEADER.LINE_VER] ~= HEADER.VERSION then
return nil, "cache header layout is outdated; expected " .. HEADER.VERSION
end
local cmd = lines[HEADER.LINE_CMD]
local nline = tonumber((lines[HEADER.LINE_NLINE] or ""):match("^%s*(%d+)%s*$"))
local w = tonumber((lines[HEADER.LINE_W] or ""):match("^%s*(%d+)%s*$"))
local h = tonumber((lines[HEADER.LINE_H] or ""):match("^%s*(%d+)%s*$"))
local t = (lines[HEADER.LINE_T] or ""):match("^%s*(%a+)%s*$")
if cmd == nil then
return nil, "missing cmd header line"
end
if not nline then
return nil, "invalid line-count header: " .. tostring(lines[HEADER.LINE_NLINE])
end
if not w then
return nil, "invalid width header: " .. tostring(lines[HEADER.LINE_W])
end
if not h then
return nil, "invalid height header: " .. tostring(lines[HEADER.LINE_H])
end
if t ~= "dark" and t ~= "light" then
return nil, "invalid theme header: " .. tostring(lines[HEADER.LINE_T])
end
return { cmd = cmd, nline = nline, w = w, h = h, t = t }, nil
end
----------------------------------------------------------------------
-- Cache generation
--
-- Behavior:
-- - If job.args[1] is present: use it as recipe.
-- - Else: if cache exists and has valid header: reuse cached recipe (LINE_CMD).
-- - Else: fail (no recipe available).
--
-- Always writes a HEADER.N-line header:
-- 1) layout marker (HEADER.VERSION)
-- 2) command template (exact string we use)
-- 3) number of content lines (wc -l, trimmed)
-- 4) width used (w, trimmed)
-- 5) height used (h, trimmed)
-- 6) terminal theme used (t)
----------------------------------------------------------------------
local function generate_cache(job, cache_path)
local source_path = fs_path(job.file.url)
-- 1) Decide template: job.args[1] or cached header
local tpl = job.args and job.args[1]
if tpl == "" then tpl = nil end
if not tpl then
local cha = fs.cha(cache_path)
if cha then
local hdr, herr = read_cache_header(cache_path)
if hdr and hdr.cmd and hdr.cmd ~= "" then
tpl = hdr.cmd
else
-- header invalid -> cannot recover recipe
ya.err("faster-piper: cache header invalid; cannot reuse recipe: " .. tostring(herr))
end
end
end
if not tpl or tpl == "" then
ya.err("faster-piper: missing generator command template (job.args[1]) and no usable cached header")
return false
end
-- Guard: template must be single-line for env passing + header layout
if tpl:find("\n", 1, true) then
ya.err("faster-piper: command template contains newline; unsupported")
return false
end
-- 2) Expand "$1" safely for external tools
--
-- ya.quote() escapes for the *host* shell by default, which on Windows is
-- cmd: it would turn `%` into `%%cd:~,` and quote with `"`. Everything here
-- is fed to `sh`, so we force POSIX escaping with the second argument.
--
-- The `%` in the replacement string is doubled because gsub reads `%1`,
-- `%0`, ... as capture references; a path containing `%` would otherwise
-- raise "invalid use of '%' in replacement string".
local quoted_source = ya.quote(source_path, true):gsub("%%", "%%%%")
local final = tpl:gsub('"$1"', quoted_source)
local out_url, hdr_url = scratch_paths_for(cache_path)
local out_path = ya.quote(tostring(out_url), true)
local hdr_path = ya.quote(tostring(hdr_url), true)
local quoted_path = ya.quote(tostring(cache_path), true)
-- 3) Generate content into a scratch file, prepend the header into a
-- second one, then rename that over cache_path.
--
-- cache_path itself is never written in place: a generator that is
-- killed halfway (Yazi cancels superseded peeks) would otherwise
-- leave a headerless stump where a perfectly good cache used to be.
--
-- - We trim whitespace from wc output to avoid leading spaces.
-- - We also trim $w and $h to be safe.
local cmd = string.format([[
(%s) > %s &&
L=$(wc -l < %s | tr -d '[:space:]') &&
W=$(printf '%%s' "$w" | tr -d '[:space:]') &&
H=$(printf '%%s' "$h" | tr -d '[:space:]') &&
{ printf '%%s\n' "$FP_VER"; printf '%%s\n' "$FP_TPL"; printf '%%s\n' "$L"; printf '%%s\n' "$W"; printf '%%s\n' "$H"; printf '%%s\n' "$t"; cat %s; } > %s &&
mv %s %s
]],
final,
out_path,
out_path,
out_path,
hdr_path,
hdr_path,
quoted_path
)
local function discard_scratch()
fs.remove("file", out_url)
fs.remove("file", hdr_url)
end
local child, err = Command("sh")
:arg({ "-c", cmd })
:env("w", tostring(job.area.w))
:env("h", tostring(job.area.h))
:env("t", current_theme())
:env("FP_TPL", tpl) -- EXACT template string we used
:env("FP_VER", HEADER.VERSION) -- header layout marker
-- Windows: a Cygwin-derived `sh` (Git Bash, MSYS2) upper-cases the
-- environment it inherits from a native process, which would turn our
-- $w/$h/$t into $W/$H/$T and leave the recipe reading empty values.
-- Harmless everywhere else. piper.yazi does the same.
:env("CYGWIN", "noupcaseenv")
:stdin(Command.NULL)
:stdout(Command.NULL)
:stderr(Command.PIPED)
:spawn()
if not child then
ya.err("faster-piper: failed to spawn: " .. tostring(err))
discard_scratch()
return false
end
local output, werr = child:wait_with_output()
if not output then
ya.err("faster-piper: wait failed: " .. tostring(werr))
discard_scratch()
return false
end
if not output.status.success then
ya.err("faster-piper: command failed (code=" .. tostring(output.status.code) .. "): " .. tostring(output.stderr))
discard_scratch()
return false
end
-- The content scratch file has served its purpose; the header one was
-- renamed away by the shell.
fs.remove("file", out_url)
-- 4) Sanity-check the newly written header
local hdr, herr = read_cache_header(cache_path)
if not hdr then
ya.err("faster-piper: wrote cache but header sanity-check failed: " .. tostring(herr))
fs.remove("file", cache_path)
return false
end
return true
end
-- -------------------------------------------------------------------
-- Ensure cache exists & is fresh; regenerate if needed
-- -------------------------------------------------------------------
local function ensure_cache(job)
local cache_path, why = get_cache_path(job)
if not cache_path then
return nil, why
end
-- Fresh -> done
if cache_is_fresh(job, cache_path) then
return cache_path
end
-- Acquire lock. It only deduplicates work: a generator that fails to
-- get it still produces a correct cache, because every generator
-- writes its own scratch files and publishes them with one rename.
local lock_path = lock_path_for(cache_path)
local locked = acquire_lock(lock_path, TIME_OUT_LOCK)
-- Hand the lock back on every exit path, including the one Yazi takes
-- when it abandons this peek.
--
-- Yazi drops the coroutine of a superseded peek at whatever await point
-- it has reached, so anything written after generate_cache() simply
-- never runs. A to-be-closed variable is closed even then, and is the
-- only hook we get. Without it a single abandoned peek wedges every
-- later peek of that file until LOCK_TTL_SEC expires; Yazi peeks twice
-- in quick succession on startup, which is enough to hit this on a
-- generator as cheap as `eza --tree`.
local _lock <close> = setmetatable({}, {
__close = function()
if locked then
release_lock(lock_path)
end
end,
})
-- Re-check: whoever held the lock may have generated it meanwhile.
-- This also covers the timed-out case, where we go on to generate
-- without the lock rather than reporting failure.
if cache_is_fresh(job, cache_path) then
return cache_path
end
if not generate_cache(job, cache_path) then
return nil, "generate-failed"
end
return cache_path
end
----------------------------------------------------------------------
-- Yazi hooks
----------------------------------------------------------------------
function M:preload(job)
-- Preload is explicitly configured -> always warm cache
local cache_path = ensure_cache(job)
return cache_path ~= nil
end
----------------------------------------------------------------------
-- NOTE ABOUT "JUMP TO END" / HUGE SCROLLS (Yazi limitation + workaround)
--
-- Problem:
-- Yazi's preview scrolling model is built around a `skip` integer that
-- is passed into `peek(job)` and represents "how many units to skip"
-- (lines for text previewers). Yazi does NOT provide:
--
-- 1) The total number of lines of the previewed content.
-- 2) Any callback where `seek()` can read user args (command, caching).
-- 3) A reliable shared Lua state between `seek()` and `peek()`.
--
-- In particular:
-- - `seek(job)` is stateless and arg-agnostic. It cannot know whether
-- caching is enabled, which generator is used, or what cache file exists.
-- - We cannot maintain a Lua table indexed by filename to store per-file
-- metadata (like total lines), because Yazi may reload the Lua state
-- between calls. So `seek()` cannot rely on anything computed earlier
-- by `peek()` or `preload()`.
--
-- Consequence:
-- When the user performs a large scroll action (e.g. PageDown held, or
-- "scroll to bottom"), Yazi may ask us to render extremely large skip
-- values. But we cannot clamp skip in `seek()` (we don't know file length),
-- and Yazi itself may sanitize/clamp very large skips in inconsistent ways.
--
-- The only place where we CAN know the "file length" is inside `peek()`:
-- because we embed the total line count in the cache file itself as the
-- first line header.
--
-- But there is a catch:
-- We MUST NOT silently change the rendering range inside `peek()`, because
-- Yazi tracks preview state using the requested skip. If we locally clamp
-- skip without telling Yazi, Yazi believes we are at one skip while we are
-- actually rendering a different one, and scrolling becomes desynchronized.
--
-- Workaround:
-- We implement "jump to end" as a two-step protocol:
--
-- (A) seek() detects a "huge scroll in one action" using ONLY job.units,
-- and emits a special sentinel skip value:
--
-- skip = cur + PEEK_JUMP_THRESHOLD + 1
--
-- The "+1" ensures skip > PEEK_JUMP_THRESHOLD even when cur == 0.
--
-- (B) peek() sees skip > PEEK_JUMP_THRESHOLD, reads `total` from the
-- cache header, and if (total <= PEEK_JUMP_THRESHOLD) then we know
-- this skip is "definitely beyond EOF", so we clamp by EMITTING a
-- NEW peek() call with skip=max_skip (last page), then return:
--
-- ya.emit("peek", { max_skip, only_if = job.file.url })
-- return
--
-- This keeps Yazi's internal state consistent because it re-runs peek
-- with the corrected skip.
--
-- (C) For very large files (total > PEEK_JUMP_THRESHOLD) we cannot jump
-- reliably without knowing the actual length ahead of time. In that
-- case we simply treat the skip as a real skip and do nothing special.
-- This is the best we can do under Yazi's constraints.
--
-- Summary:
-- - seek() cannot know file length -> cannot clamp skip.
-- - peek() CAN know file length via cache header.
-- - peek() MUST NOT locally clamp -> must re-emit peek() with corrected skip.
-- - sentinel skips are used to request "jump-to-end" in a stateless way.
--
-- Do NOT remove this logic unless Yazi gains:
-- - a reliable shared Lua state between calls, OR
-- - total line count passed into preview jobs, OR
-- - a preview API that supports clamping without desync.
----------------------------------------------------------------------
function M:seek(job)
-- SEEK MUST BE STATELESS AND ARG-AGNOSTIC
-- Yazi does not provide information in job whether the cache is present
-- and what command generated the preview content
local cur = cx.active.preview.skip or 0
local units = job.units or 0
-- Candidate skip (absolute)
local new_skip = cur + units
-- Fast path: if user scrolls *way* up in one action, jump to top.
if units < -SKIP_JUMP_THRESHOLD then
new_skip = 0
end
if units > SKIP_JUMP_THRESHOLD then
ya.emit("peek", { cur + PEEK_JUMP_THRESHOLD + 1, only_if = job.file.url })
return
end
new_skip = math.max(0, new_skip)
ya.emit("peek", { new_skip, only_if = job.file.url })
end
function M:peek(job)
local cache_path, why
local hdr, herr
if is_true(job.args.rely_on_preloader,false) then
cache_path, why = get_cache_path(job)
if not cache_path then
ya.preview_widget(job, ui.Text.parse("faster-piper: " .. tostring(why)):area(job.area))
return
end
local ok
ok, hdr = cache_is_fresh(job, cache_path) -- hdr is assured to be nil when ok==false
if not ok then
-- If the cache file exists, we can self-heal (resize case) by reusing cmd from header.
if fs.cha(cache_path) then
local ensured, ewhy = ensure_cache(job)
if ensured then
cache_path = ensured
else
ya.preview_widget(job,
ui.Text.parse("faster-piper: failed to refresh cache: " .. tostring(ewhy)):area(job.area)
)
return
end
else
-- Cache file doesn't exist (save-race): wait briefly for preloader to write it.
local ok2
ok2, hdr = wait_for_ready_cache(job, cache_path, TIME_OUT_PREVIEW)
if not ok2 then
ya.preview_widget(job,
ui.Text.parse("faster-piper: ⏳ preview is taking longer than expected. Try selecting the file again."):area(job.area)
)
return
end
end
end
else
cache_path, why = ensure_cache(job)
if not cache_path then
ya.preview_widget(job, ui.Text.parse("faster-piper: " .. tostring(why)):area(job.area))
return
end
end
-- If hdr not already available/reliable, read it once here
if not hdr then hdr, herr = read_cache_header(cache_path) end
if hdr then
local total = hdr.nline
local limit = job.area.h
local max_skip = math.max(0, total - limit)
local skip = job.skip or 0
if total <= PEEK_JUMP_THRESHOLD and skip > PEEK_JUMP_THRESHOLD and skip ~= max_skip then
ya.emit("peek", { max_skip, only_if = job.file.url })
return
end
if skip > max_skip then
ya.emit("peek", { max_skip, only_if = job.file.url })
return
end
else
ya.err("faster-piper: failed to read cache header: " .. tostring(herr))
end
local limit = job.area.h
local skip = job.skip or 0
-- content starts after HEADER.N lines of header
local start = skip + content_first_line()
local stop = start + limit - 1
local lines, err = read_line_range(tostring(cache_path), start, stop)
if not lines then
ya.preview_widget(job, ui.Text.parse("faster-piper: read(slice): " .. tostring(err)):area(job.area))
return
end
-- The slice starts past the header, so it is pure content.
local slice = #lines > 0 and (table.concat(lines, "\n") .. "\n") or ""
if job.args.format == "url" then
ya.preview_widget(job, M.format(job, split_lines(slice)))
else
ya.preview_widget(job, ui.Text.parse(slice):area(job.area))
end
end
-- -------------------------------------------------------------------
-- entry(): called by `run = 'plugin faster-piper ...'` keybindings
-- -------------------------------------------------------------------
function M:entry(job)
return
end
return M
@@ -1,6 +1,6 @@
MIT License MIT License
Copyright (c) 2024 Sonico98 Copyright (c) 2023 yazi-rs
Permission is hereby granted, free of charge, to any person obtaining a copy Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal
@@ -0,0 +1,28 @@
# smart-filter.yazi
A Yazi plugin that makes filters smarter: continuous filtering, automatically enter unique directory, open file on submitting.
https://github.com/yazi-rs/plugins/assets/17523360/72aaf117-1378-4f7e-93ba-d425a79deac5
## Installation
```sh
ya pkg add yazi-rs/plugins:smart-filter
```
## Usage
Add this to your `~/.config/yazi/keymap.toml`:
```toml
[[mgr.prepend_keymap]]
on = "F"
run = "plugin smart-filter"
desc = "Smart filter"
```
Note that, the keybindings above are just examples, please tune them up as needed to ensure they don't conflict with your other actions/plugins.
## License
This plugin is MIT-licensed. For more information check the [LICENSE](LICENSE) file.
@@ -0,0 +1,50 @@
--- @since 25.12.29
local hovered = ya.sync(function()
local h = cx.active.current.hovered
if not h then
return {}
end
return {
url = h.url,
is_dir = h.cha.is_dir,
unique = #cx.active.current.files == 1,
}
end)
local function prompt()
return ya.input {
title = "Smart filter:",
pos = { "top-center", y = 2, w = 50 },
realtime = true,
debounce = 0.1,
}
end
local function entry()
local input = prompt()
while true do
local value, event = input:recv()
if event ~= 1 and event ~= 3 then
ya.emit("escape", { filter = true })
break
end
ya.emit("filter_do", { value, smart = true })
local h = hovered()
if h.unique and h.is_dir then
ya.emit("escape", { filter = true })
ya.emit("enter", {})
input = prompt()
elseif event == 1 then
ya.emit("escape", { filter = true })
ya.emit(h.is_dir and "enter" or "open", { h.url })
break
end
end
end
return { entry = entry }
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2023 yazi-rs
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.
@@ -0,0 +1,80 @@
# toggle-pane.yazi
Toggle the show, hide, and maximize states for different panes: parent, current, and preview. It respects the user's [`ratio` settings](https://yazi-rs.github.io/docs/configuration/yazi#mgr.ratio)!
Assume the user's `ratio` is $$[A, B, C]$$, that is, $$\text{parent}=A, \text{current}=B, \text{preview}=C$$:
- `min-parent`: Toggles between $$0$$ and $$A$$ - the parent is either completely hidden or showed with width $$A$$.
- `max-parent`: Toggles between $$A$$ and $$\infty$$ - the parent is either showed with width $$A$$ or fills the entire screen.
- `min-current`: Toggles between $$0$$ and $$B$$ - the current is either completely hidden or showed with width $$B$$.
- `max-current`: Toggles between $$B$$ and $$\infty$$ - the current is either showed with width $$B$$ or fills the entire screen.
- `min-preview`: Toggles between $$0$$ and $$C$$ - the preview is either completely hidden or showed with width $$C$$.
- `max-preview`: Toggles between $$C$$ and $$\infty$$ - the preview is either showed with width $$C$$ or fills the entire screen.
- `reset`: Resets to the user's configured `ratio`.
## Installation
```sh
ya pkg add yazi-rs/plugins:toggle-pane
```
## Usage
Hide/Show preview:
```toml
# keymap.toml
[[mgr.prepend_keymap]]
on = "T"
run = "plugin toggle-pane min-preview"
desc = "Show or hide the preview pane"
```
Maximize/Restore preview:
```toml
# keymap.toml
[[mgr.prepend_keymap]]
on = "T"
run = "plugin toggle-pane max-preview"
desc = "Maximize or restore the preview pane"
```
You can replace `preview` with `current` or `parent` to toggle the other panes.
Note that, the keybindings above are just examples, please tune them up as needed to ensure they don't conflict with your other actions/plugins.
## Advanced
In addition to triggering the plugin with a keypress, you can also trigger it in your `init.lua` file:
```lua
if os.getenv("NVIM") then
require("toggle-pane"):entry("min-preview")
end
```
In the example above, when it detects that you're [using Yazi in nvim](https://yazi-rs.github.io/docs/resources#vim), the preview is hidden by default — you can always press `T` (or any key you've bound) to show it again.
## Tips
This plugin only maximizes the "available preview area", without actually changing the content size.
This means that the appearance of your preview largely depends on the previewer you are using.
However, most previewers tend to make the most of the available space, so this usually isn't an issue.
For image previews, you may want to tune up the [`max_width`][max-width] and [`max_height`][max-height] options in your `yazi.toml`:
```toml
[preview]
# Change them to your desired values
max_width = 1000
max_height = 1000
```
[max-width]: https://yazi-rs.github.io/docs/configuration/yazi/#preview.max_width
[max-height]: https://yazi-rs.github.io/docs/configuration/yazi/#preview.max_height
## License
This plugin is MIT-licensed. For more information, check the [LICENSE](LICENSE) file.
@@ -0,0 +1,48 @@
--- @since 26.8.15
--- @sync entry
local PANE = { parent = 1, current = 2, preview = 3 }
local function eq(other)
local r = rt.mgr.ratio
return other[1] == r[1] and other[2] == r[2] and other[3] == r[3]
end
local function get()
local r = rt.mgr.ratio
return { r[1], r[2], r[3] }
end
local function set(new) rt.mgr.ratio = { new[1], new[2], new[3] } end
local function entry(st, job)
job = type(job) == "string" and { args = { job } } or job
if not eq(st.new or {}) then
st.new, st.old = nil, nil
end
local N, O = st.new or get(), st.old or get()
local act, to = string.match(job.args[1] or "", "(.-)-(.+)")
local i = PANE[to]
if act == "min" then
N[i] = N[i] == O[i] and 0 or O[i]
elseif act == "max" then
local max = N[i] == 9999 and O[i] or 9999
N[1] = N[1] == 9999 and O[1] or N[1]
N[2] = N[2] == 9999 and O[2] or N[2]
N[3] = N[3] == 9999 and O[3] or N[3]
N[i] = max
end
if act then
st.new, st.old = N, O
else
N, st.new, st.old = O, nil, nil
end
set(N)
ya.emit("app:resize", {})
end
return { entry = entry }
@@ -1,5 +1,14 @@
zshrc /home/liph/dotfiles/zshrc z
yazi /home/liph/dotfiles/yazi/.config/yazi d,y
tank /mnt/tank T,T
nvim /home/liph/dotfiles/nvim/.config/nvim d,n
niri /home/liph/dotfiles/niri/.config/niri d,N
mnt /mnt M
home /home/liph f home /home/liph f
herdr /home/liph/dotfiles/herdr/.config/herdr d,h
flash1 /mnt/flash1 T,f
Downloads /home/liph/Downloads D,d Downloads /home/liph/Downloads D,d
dotfiles /home/liph/dotfiles d,d dotfiles /home/liph/dotfiles d,d
Documents /home/liph/Documents D,D Documents /home/liph/Documents D,D
.config /home/liph/.config c .config /home/liph/.config c
aerc /home/liph/dotfiles/aerc/aerc d,a
@@ -0,0 +1,7 @@
Copyright 2024 grappas
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.
@@ -0,0 +1,34 @@
# wl-clipboard.yazi
Forked from: [orhnk/system-clipboard.yazi](https://github.com/orhnk/system-clipboard.yazi) to work with wayland compositors.
## Demo
<https://github.com/user-attachments/assets/74d59f49-266a-497e-b67e-d77e64209026>
## Config
> [!NOTE]
> You need yazi 3.x for this plugin to work.
> [!Important]
> This plugin utilizes ["wl-clipboard" project](https://github.com/bugaevc/wl-clipboard).
> You need to have it installed on your system. (Make sure that It's on your $PATH)
## Installation
```bash
ya pkg add grappas/wl-clipboard
```
## Configuration
Copy or install this plugin and add the following keymap to your `manager.prepend_keymap`:
```toml
on = "<C-y>"
run = ["plugin wl-clipboard"]
```
> [!Tip]
> If you want to use this plugin with yazi's default yanking behaviour you should use `cx.yanked` instead of `tab.selected` in `init.lua` (See [#1487](https://github.com/sxyazi/yazi/issues/1487))
@@ -0,0 +1,60 @@
-- Meant to run at async context. (yazi system-clipboard)
local selected_or_hovered = ya.sync(function()
local tab, paths = cx.active, {}
for _, u in pairs(tab.selected) do
paths[#paths + 1] = tostring(u)
end
if #paths == 0 and tab.current.hovered then
paths[1] = tostring(tab.current.hovered.url)
end
return paths
end)
return {
entry = function()
ya.emit("escape", { visual = true })
local urls = selected_or_hovered()
if #urls == 0 then
return ya.notify({ title = "System Clipboard", content = "No file selected", level = "warn", timeout = 5 })
end
-- ya.notify({ title = #urls, content = table.concat(urls, " "), level = "info", timeout = 5 })
-- Format the URLs for `text/uri-list` specification
local function encode_uri(uri)
return uri:gsub("([^%w%-%._~:/])", function(c)
return string.format("%%%02X", string.byte(c))
end)
end
local file_list_formatted = ""
for _, path in ipairs(urls) do
-- Each file path must be URI-encoded and prefixed with "file://"
file_list_formatted = file_list_formatted .. "file://" .. encode_uri(path) .. "\r\n"
end
local status, err =
Command("wl-copy"):arg("--type"):arg("text/uri-list"):arg(file_list_formatted):spawn():wait()
if status or status.succes then
ya.notify({
title = "System Clipboard",
content = "Succesfully copied the file(s) to system clipboard",
level = "info",
timeout = 5,
})
end
if not status or not status.success then
ya.notify({
title = "System Clipboard",
content = string.format("Could not copy selected file(s) %s", status and status.code or err),
level = "error",
timeout = 5,
})
end
end,
}
+31 -7
View File
@@ -12,7 +12,7 @@ sort_dir_first = true
sort_translit = false sort_translit = false
sort_fallback = "alphabetical" sort_fallback = "alphabetical"
linemode = "none" linemode = "none"
show_hidden = false show_hidden = true
show_symlink = true show_symlink = true
scrolloff = 5 scrolloff = 5
mouse_events = ["click", "scroll", "drag"] mouse_events = ["click", "scroll", "drag"]
@@ -20,8 +20,8 @@ mouse_events = ["click", "scroll", "drag"]
[preview] [preview]
wrap = "no" wrap = "no"
tab_size = 2 tab_size = 2
max_width = 600 max_width = 800
max_height = 900 max_height = 1200
cache_dir = "" cache_dir = ""
image_delay = 30 image_delay = 30
image_filter = "triangle" image_filter = "triangle"
@@ -143,10 +143,14 @@ fetchers = [
] ]
prepend_fetchers = [ prepend_fetchers = [
#####################################################################
### git ### ### git ###
#####################################################################
{ url = "*", run = "git", group = "git" }, { url = "*", run = "git", group = "git" },
{ url = "*/", run = "git", group = "git" }, { url = "*/", run = "git", group = "git" },
#####################################################################
### mime-ext ### ### mime-ext ###
#####################################################################
{ url = "local://*", run = "mime-ext.local", prio = "high", group = "mime" }, { url = "local://*", run = "mime-ext.local", prio = "high", group = "mime" },
{ url = "remote://*", run = "mime-ext.remote", prio = "high", group = "mime" }, { url = "remote://*", run = "mime-ext.remote", prio = "high", group = "mime" },
] ]
@@ -195,7 +199,15 @@ preloaders = [
] ]
prepend_preloaders = [ prepend_preloaders = [
#####################################################################
### piper ###
#####################################################################
{ url = "*.md", run = 'faster-piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dracula -- "$1"' },
{ url = "*.tar*", run = 'faster-piper -- tar tf "$1"' },
{ url = "*.txt.gz", run = 'faster-piper -- gzip -dc "$1"' },
#####################################################################
### mediainfo ### ### mediainfo ###
#####################################################################
# Replace magick, image, video with mediainfo # Replace magick, image, video with mediainfo
{ mime = "{audio,video,image}/*", run = "mediainfo" }, { mime = "{audio,video,image}/*", run = "mediainfo" },
# .srt subtitle, adobe illustrator, adobe photoshop file # .srt subtitle, adobe illustrator, adobe photoshop file
@@ -247,29 +259,41 @@ previewers = [
{ mime = "trash/**", run = "trash" }, { mime = "trash/**", run = "trash" },
# Error # Error
{ mime = "null/*", run = "null" }, { mime = "null/*", run = "null" },
# # Fallback # Fallback
# { url = "*", run = "file" }, { url = "*", run = "file" },
] ]
append_previewers = [ append_previewers = [
#####################################################################
### extra-metadata ### ### extra-metadata ###
#####################################################################
{ url = "*", run = "file-extra-metadata" }, { url = "*", run = "file-extra-metadata" },
# Setup keybind for spotter: https://github.com/sxyazi/yazi/pull/1802 # Setup keybind for spotter: https://github.com/sxyazi/yazi/pull/1802
] ]
prepend_previewers = [ prepend_previewers = [
####################################################################
### piper ###
#####################################################################
{ url = "*.md", run = 'faster-piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dracula -- "$1"' },
{ url = "*.tar*", run = 'faster-piper -- tar tf "$1"' },
{ url = "*.txt.gz", run = 'faster-piper -- gzip -dc "$1"' },
####################################################################
### rich-preview ### ### rich-preview ###
#####################################################################
{ url = "*.csv", run = "rich-preview" }, # for csv files { url = "*.csv", run = "rich-preview" }, # for csv files
{ url = "*.md", run = "rich-preview" }, # for markdown (.md) files { url = "*.md", run = "rich-preview" }, # for markdown (.md) files
{ url = "*.rst", run = "rich-preview" }, # for restructured text (.rst) files { url = "*.rst", run = "rich-preview" }, # for restructured text (.rst) files
{ url = "*.ipynb", run = "rich-preview" }, # for jupyter notebooks (.ipynb) { url = "*.ipynb", run = "rich-preview" }, # for jupyter notebooks (.ipynb)
{ url = "*.json", run = "rich-preview" }, # for json (.json) files { url = "*.json", run = "rich-preview" }, # for json (.json) files
# { url = "*.lang_type", run = "rich-preview"} # for particular language files eg. .py, .go., .lua, etc. # { url = "*.lang_type", run = "rich-preview"} # for particular language files eg. .py, .go., .lua, etc.
# ### exifaudio ### #####################################################################
# { mime = "audio/*", run = "exifaudio" },
### eza-preview ### ### eza-preview ###
#####################################################################
{ url = "*/", run = "eza-preview" }, { url = "*/", run = "eza-preview" },
#####################################################################
### mediainfo ### ### mediainfo ###
#####################################################################
# Replace magick, image, video with mediainfo # Replace magick, image, video with mediainfo
{ mime = "{audio,video,image}/*", run = "mediainfo" }, { mime = "{audio,video,image}/*", run = "mediainfo" },
# .srt subtitle, adobe illustrator, adobe photoshop file # .srt subtitle, adobe illustrator, adobe photoshop file
+5
View File
@@ -60,6 +60,11 @@ alias nlof="~/scripts/fzf_listoldfiles.sh"
# alias fman="compgen -c | fzf | xargs man" # alias fman="compgen -c | fzf | xargs man"
## herdr ## herdr
alias hh="herdr"
alias hsa="hh session attach"
alias hsl="hh session list"
alias hss="hh session stop"
alias hsd="hh session delete"
# alias heh="herdr && herdr-spreader apply [--file ~/.config/herdr/plugins/config/herdr-spreader/home.yml]" # alias heh="herdr && herdr-spreader apply [--file ~/.config/herdr/plugins/config/herdr-spreader/home.yml]"
# alias hec="herdr-spreader apply [--file ~/.config/herdr/plugins/config/herdr-spreader/code.yml]" # alias hec="herdr-spreader apply [--file ~/.config/herdr/plugins/config/herdr-spreader/code.yml]"