Updated the manuals

Add PowerShell script to create and activate a custom power plan

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [fleschutz] # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]

Data/Abbr/mathematics.csv

@@ -1,269 +0,0 @@
-ABBR,MEANING
-AC,"Axiom of Choice, or set of absolutely continuous functions."
-a.c.,absolutely continuous.
-acrd,inverse chord function.
-ad,adjoint representation (or adjoint action) of a Lie group.
-adj,adjugate of a matrix.
-a.e.,almost everywhere.
-Ai,Airy function.
-AL,Action limit.
-Alt,alternating group (Alt(n) is also written as An.)
-A.M.,arithmetic mean.
-arccos,inverse cosine function.
-arccosec,inverse cosecant function. (Also written as arccsc.)
-arccot,inverse cotangent function.
-arccsc,inverse cosecant function. (Also written as arccosec.)
-arcexc,"inverse excosecant function. (Also written as arcexcsc, arcexcosec.)"
-arcexcosec,"inverse excosecant function. (Also written as arcexcsc, arcexc.)"
-arcexcsc,"inverse excosecant function. (Also written as arcexcosec, arcexc.)"
-arcexs,inverse exsecant function. (Also written as arcexsec.)
-arcexsec,inverse exsecant function. (Also written as arcexs.)
-arcosech,inverse hyperbolic cosecant function. (Also written as arcsch.)
-arcosh,inverse hyperbolic cosine function.
-arcoth,inverse hyperbolic cotangent function.
-arcsch,inverse hyperbolic cosecant function. (Also written as arcosech.)
-arcsec,inverse secant function.
-arcsin,inverse sine function.
-arctan,inverse tangent function.
-arctan2,inverse tangent function with two arguments. (Also written as atan2.)
-arg,argument of
-arg max,argument of the maximum.
-arg min,argument of the minimum.
-arsech,inverse hyperbolic secant function.
-arsinh,inverse hyperbolic sine function.
-artanh,inverse hyperbolic tangent function.
-a.s.,almost surely.
-atan2,inverse tangent function with two arguments. (Also written as arctan2.)
-A.P.,arithmetic progression.
-Aut,automorphism group.
-bd,boundary. (Also written as fr or ∂.)
-Bi,Airy function of the second kind.
-BIDMAS,"Brackets, Indices, Divide, Multiply, Add, Subtract."
-Bias,bias of an estimator
-BWOC,by way of contradiction
-Card,"cardinality of a set. (Card(X) is also written #X, ♯X or |X|.)"
-cas,cos + sin function.
-cdf,cumulative distribution function.
-c.f.,cumulative frequency.
-c.c.,complex conjugate.
-char,characteristic of a ring.
-Chi,hyperbolic cosine integral function.
-Ci,cosine integral function.
-cis,cos + i sin function. (Also written as expi.)
-Cl,conjugacy class.
-cl,topological closure.
-CLT,central limit theorem.
-cod,"codom,codomain."
-cok,"coker,cokernel."
-conv,convex hull of a set.
-Cor,corollary.
-corr,correlation.
-cos,cosine function.
-cosec,cosecant function. (Also written as csc.)
-cosech,hyperbolic cosecant function. (Also written as csch.)
-cosh,hyperbolic cosine function.
-cosiv,"coversine function. (Also written as cover, covers, cvs.)"
-cot,cotangent function. (Also written as ctg.)
-coth,hyperbolic cotangent function.
-cov,covariance of a pair of random variables.
-cover,"coversine function. (Also written as covers, cvs, cosiv.)"
-covercos,covercosine function. (Also written as cvc.)
-covers,"coversine function. (Also written as cover, cvs, cosiv.)"
-crd,chord function.
-csc,cosecant function. (Also written as cosec.)
-csch,hyperbolic cosecant function. (Also written as cosech.)
-ctg,cotangent function. (Also written as cot.)
-curl,curl of a vector field. (Also written as rot.)
-cvc,covercosine function. (Also written as covercos.)
-cvs,"coversine function. (Also written as cover, covers, cosiv.)"
-def,define or definition.
-deg,"degree of a polynomial, or other recursively-defined objects such as well-formed formulas. (Also written as ∂.)"
-del,"del, a differential operator. (Also written as {\displaystyle \nabla }\nabla .)"
-det,determinant of a matrix or linear transformation.
-dim,dimension of a vector space.
-div,divergence of a vector field.
-DNE,"a solution for an expression does not exist, or is undefined. Generally used with limits and integrals."
-dom,"domain of a function. (Or, more generally, a relation.)"
-End,categories of endomorphisms.
-Ei,exponential integral function.
-epi,epigraph of a function.
-Eqn,equation.
-erf,error function.
-erfc,complementary error function.
-etr,exponent of the trace.
-exc,"excosecant function. (Also written as excsc, excosec.)"
-excosec,"excosecant function. (Also written as excsc, exc.)"
-excsc,"excosecant function. (Also written as excosec, exc.)"
-exs,exsecant function. (Also written as exsec.)
-exsec,exsecant function. (Also written as exs.)
-exp,exponential function. (exp x is also written as ex.)
-expi,cos + i sin function. (Also written as cis.)
-expm1,exponential minus 1 function. (Also written as exp1m.)
-exp1m,exponential minus 1 function. (Also written as expm1.)
-Ext,Ext functor.
-ext,exterior.
-extr,a set of extreme points of a set.
-FIP,finite intersection property.
-FOC,first order condition.
-FOL,first-order logic.
-fr,boundary. (Also written as bd or ∂.)
-Frob,Frobenius endomorphism.
-Gal,Galois group. (Also written as Γ.)
-gcd,greatest common divisor of two numbers. (Also written as hcf.)
-gd,Gudermannian function.
-GF,Galois field.
-GF,generating function.
-GL,general linear group.
-GM,geometric mean.
-glb,greatest lower bound. (Also written as inf.)
-GP,geometric progression.
-grad,gradient of a function.
-hacover,"hacoversine function. (Also written as hacovers, hcv.)"
-hacovercos,hacovercosine function. (Also written as hcc.)
-hacovers,"hacoversine function. (Also written as hacover, hcv.)"
-hav,haversine function. (Also written as sem.)
-havercos,havercosine function. (Also written as hvc.)
-hcc,hacovercosine function. (Also written as hacovercos.)
-hcv,"hacoversine function. (Also written as hacover, hacovers.)"
-hcf,highest common factor of two numbers. (Also written as gcd.)
-H.M.,harmonic mean.
-HOL,higher-order logic.
-Hom,Hom functor.
-hom,hom-class.
-hot,higher order term
-HOTPO,half or triple plus one
-hvc,havercosine function. (Also written as havercos.)
-hyp,hypograph of a function.
-iff,if and only if.
-IH,induction hypothesis.
-iid,independent and identically distributed random variables.
-Im,imaginary part of a complex number (Also written as {\displaystyle \Im }\Im ).
-im,image
-inf,infimum of a set. (Also written as glb.)
-int,interior.
-I.o.,Infinitely often.
-ker,kernel.
-lb,binary logarithm (log2). (Also written as ld.)
-lcm,lowest common multiple (a.k.a. least common multiple) of two numbers.
-LCHS,locally compact Hausdorff second countable.
-ld,binary logarithm (log2). (Also written as lb.)
-lerp,linear interpolation.[5]
-lg,common logarithm (log10) or binary logarithm (log2).
-LHS,left-hand side of an equation.
-Li,offset logarithmic integral function.
-li,logarithmic integral function or linearly independent.
-lim,"limit of a sequence, or of a function."
-lim inf,limit inferior.
-lim sup,limit superior.
-LLN,law of large numbers.
-ln,"natural logarithm, loge."
-lnp1,natural logarithm plus 1 function.
-ln1p,natural logarithm plus 1 function.
-log,"logarithm. (If without a subscript, this may mean either log10 or loge.)"
-logh,"natural logarithm, loge."
-LST,language of set theory.
-lub,least upper bound. (Also written sup.)
-max,maximum of a set.
-MGF,moment-generating function.
-M.I.,mathematical induction.
-min,minimum of a set.
-mod,modulo.
-Mp,metaplectic group.
-mtanh,modified hyperbolic tangent function. (Also written as mth.)
-mth,modified hyperbolic tangent function. (Also written as mtanh.)
-mx,matrix.
-NAND,not-and in logic.
-No.,number.
-NOR,not-or in logic.
-NTS,need to show.
-OBGF,ordinary bivariate generating function.
-ob,object class.
-ord,ordinal number of a well-ordered set.[4]
-pdf,probability density function.
-pf,proof.
-PGL,projective general linear group.
-PI,the constant 3.14159265359
-Pin,pin group.
-pmf,probability mass function.
-Pn,previous number.
-Pr,probability of an event
-PSL,projective special linear group.
-PSO,projective orthogonal group.
-PSU,projective special unitary group.
-PU,projective unitary group.
-QED,"Quod erat demonstrandum, a Latin phrase used at the end of a definitive proof."
-QEF,"quod erat faciendum, a Latin phrase sometimes used at the end of a geometrical construction."
-ran,range of a function.
-rank,rank of a matrix. (Also written as rk.)
-Re,real part of a complex number
-resp,respectively.
-RHS,right-hand side of an equation.
-rk,rank. (Also written as rank.)
-RMS,"rms,root mean square."
-rng,non-unital ring.
-rot,rotor of a vector field. (Also written as curl.)
-RTP,required to prove.
-RV,random variable. (or as R.V.)
-R,Real numbers
-SD,standard deviation
-SE,standard error
-sec,secant function.
-sech,hyperbolic secant function.
-seg,initial segment of.[1]
-sem,haversine function. (Also written as hav.)
-SFIP,strong finite intersection property.
-sgn,sign function.
-Shi,hyperbolic sine integral function.
-Si,sine integral function.
-sin,sine function.
-sinc,sinc function.
-sinh,hyperbolic sine function.
-siv,"versine function. (Also written as ver, vers.)"
-SL,special linear group.
-SO,special orthogonal group.
-SOC,second order condition.
-Soln,solution.
-Sp,symplectic group.
-Sp,"trace of a matrix, from the German 'spur' used for the trace."
-sp,"linear span of a set of vectors. (Also written as span or written with angle brackets.)"
-Spec,spectrum of a ring.
-Spin,spin group.
-s.t.,such that or so that or subject to.
-st,standard part function.
-STP,[it is] sufficient to prove.
-SU,special unitary group.
-sup,"supremum of a set. (Also written as lub, which stands for least upper bound.)"
-supp,support of a function.
-swish,"swish function, an activation function in data analysis."
-Sym,"symmetric group (Sym(n) is also written as Sn) or symmetric algebra."
-tan,"tangent function. (Also written as tgn, tg.)"
-tanh,hyperbolic tangent function.
-TAU,"the constant 6.283185307179586476925286766559"
-TFAE,the following are equivalent.
-tg,"tangent function. (Also written as tan, tgn.)"
-tgn,"tangent function. (Also written as tan, tg.)"
-Thm,theorem.
-Tor,Tor functor.
-Tr,"trace, either the field trace, or the trace of a matrix or linear transformation."
-undef,a function or expression is undefined
-V,volume.
-var,variance of a random variable.
-vcs,vercosine function. (Also written as vercos.)
-ver,"versine function. (Also written as vers, siv.)"
-vercos,vercosine function. (Also written as vcs.)
-vers,"versine function. (Also written as ver, siv.)"
-W^5,"which was what we wanted. Synonym of Q.E.D."
-walog,without any loss of generality.
-wff,well-formed formula.
-whp,with high probability.
-wlog,without loss of generality.
-WMA,we may assume.
-WO,well-ordered set
-wp1,with probability 1.
-wrt,with respect to or with regard to.
-WTP,want to prove
-WTS,want to show
-XOR,exclusive or in logic
-XYZ,"Cartesian coordinate system (x,y,z)"
-ZF,Zermelo–Fraenkel axioms of set theory
-ZFC,Zermelo–Fraenkel axioms (with the Axiom of Choice) of set theory

Data/Checklists/handwashing.txt

@@ -1,6 +0,0 @@
-HEAD Handwashing
-Wet your hands with clean, running water (warm or cold), turn off the tap, and apply soap.
-Lather your hands by rubbing them together with the soap. Lather the backs of your hands, between your fingers, and under your nails.
-Scrub your hands for at least 20 seconds.
-Rinse your hands well under clean, running water.
-Dry your hands using a clean towel or air dry them.

Data/TIOBE-index.csv

@@ -1,21 +0,0 @@
-LANGUAGE, POPULARITY, CHANGE
-C, 12.54, -4.65
-Python, 11.84, +3.48
-Java, 11.54, -4.56
-C++, 7.36, +1.41
-C#, 4.33, -0.40
-Visual Basic, 4.01, -0.68
-JavaScript, 2.33, +0.06
-PHP, 2.21, -0.05
-Assembly language, 2.05, +1.09
-SQL, 1.88, +0.15
-Classic Visual Basic, 1.72, +1.07
-Groovy, 1.29, +0.87
-Ruby, 1.23, +0.25
-R, 1.20, -0.99
-Perl, 1.18, +0.36
-Swift, 1.10, -0.35
-Fortran, 1.07, +0.80
-Delphi/Object Pascal, 1.06, +0.47
-MATLAB, 1.05, +0.15
-Go, 0.95, -0.06

Data/Templates/serenade.txt

@@ -1 +0,0 @@
-/* Exported by export-scripts2serenade.ps1 */

Data/jokes.csv

@@ -1,69 +0,0 @@
-JOKE
-"Chuck Norris doesnt read books. He stares them down until he gets the information he wants."
-"Time waits for no man. Unless that man is Chuck Norris."
-"If you spell Chuck Norris in Scrabble, you win. Forever."
-"Chuck Norris breathes air five times a day."
-"In the Beginning there was nothing then Chuck Norris roundhouse kicked nothing and told it to get a job."
-"Chuck Norris has a mug of nails instead of coffee in the morning."
-"If Chuck Norris were to travel to an alternate dimension in which there was another Chuck Norris and they both fought, they would both win."
-"The dinosaurs looked at Chuck Norris the wrong way once. You know what happened to them."
-"Chuck Norris tears cure cancer. Too bad he has never cried."
-"Chuck Norris once roundhouse kicked someone so hard that his foot broke the speed of light"
-"Since 1940, the year Chuck Norris was born, roundhouse kick related deaths have increased 13,000 percent."
-"Chuck Norris does not own a stove, oven, or microwave , because revenge is a dish best served cold."
-"Chuck Norris does not sleep. He waits."
-"There is no chin behind Chuck Norris beard. There is only another fist."
-"The chief export of Chuck Norris is pain."
-"Chuck Norris recently had the idea to sell his pee as a canned beverage. Its now called Red Bull."
-"If paper beats rock, rock beats scissors, and scissors beats paper, what beats all 3 at the same time? Chuck Norris."
-"On the 7th day, God rested  Chuck Norris took over."
-"Chuck Norris can dribble a bowling ball."
-"Chuck Norris drinks napalm to fight his heartburn."
-"Chuck Norris roundhouse kick is so powerful, it can be seen from outer space by the naked eye."
-"If you want a list of Chuck Norris enemies, just check the extinct species list."
-"Chuck Norris has never blinked in his entire life. Never."
-"Chuck Norris does not use spell check. If he happens to misspell a word, Oxford will change the spelling."
-"Some kids pee their name in the snow. Chuck Norris can pee his name into concrete."
-"Chuck Norris counted to infinity twice."
-"Chuck Norris can speak Braille."
-"Chuck Norris can have both feet on the ground and kick butt at the same time."
-"Chuck Norris can do a wheelie on a unicycle."
-"Chuck Norris stands faster than anyone can run."
-"Once a cobra bit Chuck Norris leg. After five days of excruciating pain, the cobra died."
-"Chuck Norris once won a game of Connect Four in three moves."
-"Champions are the breakfast of Chuck Norris."
-"When the Boogeyman goes to sleep every night he checks his closet for Chuck Norris."
-"Chuck Norris can slam revolving doors."
-"Chuck Norris does not hunt because the word hunting implies the possibility of failure. Chuck Norris goes killing."
-"The dark is afraid of Chuck Norris."
-"Chuck Norris makes onions cry."
-"Death once had a near-Chuck-Norris experience."
-"When Chuck Norris writes, he makes paper bleed."
-"Chuck Norris can strangle you with a cordless phone."
-"Chuck Norris never retreats; He just attacks in the opposite direction."
-"Chuck Norris can build a snowman out of rain."
-"Chuck Norris can drown a fish."
-"When Chuck Norris enters a room, he doesnt turn the lights on, he turns the dark off."
-"The only time Chuck Norris was ever wrong was when he thought he had made a mistake."
-"Chuck Norris is the only person that can punch a cyclops between the eye."
-"Chuck Norris used to beat up his shadow because it was following to close. It now stands 15 feet behind him."
-"Outer space exists because its afraid to be on the same planet with Chuck Norris."
-"When Chuck Norris does a pushup, he's pushing the Earth down."
-"Chuck Norris doesnt wear a watch. He decides what time it is."
-"Chuck Norris does not get frostbite. Chuck Norris bites frost."
-"Chuck Norris spices up his steaks with pepper spray."
-"The Great Wall of China was originally created to keep Chuck Norris out. It didn't work."
-"Chuck Norris can get in a bucket and lift it up with himself in it."
-"Chuck Norris doesn't shower, he only takes blood baths."
-"Chuck Norris can divide by zero."
-"Chuck Norris once kicked a horse in the chin. Its descendants are now known as giraffes."
-"When Chuck Norris does division, there are no remainders."
-"It takes Chuck Norris 20 minutes to watch '60 Minutes'."
-"Chuck Norris once went skydiving, but promised never to do it again. One Grand Canyon is enough."
-"We live in an expanding universe. All of it is trying to get away from Chuck Norris."
-"Chuck Norris beat the sun in a staring contest."
-"Chuck Norris can clap with one hand."
-"Chuck Norris doesn't need to shave. His beard is scared to grow."
-"Chuck Norris invented airplanes because he was tired of being the only person that could fly."
-"Freddy Krueger has nightmares about Chuck Norris."
-"Chuck Norris can start a fire with an ice cube."

Data/popular-domains.csv

@@ -1,201 +0,0 @@
-DOMAIN
-a.root-servers.net
-accounts.google.com
-activity.windows.com
-airbnb.at
-airbnb.com
-airbnb.de
-aka.ms
-alternate.de
-api.dropboxapi.com
-api.met.no
-api.serenade.ai
-api1.origin.com
-arc.msn.com
-arte.tv
-assets.msn.com
-amazon.com
-amazon.co.uk
-amazon.de
-amazon.fr
-amazon.it
-b.root-servers.net
-banking.ing-diba.de
-bing.com
-bing.de
-bing.fr
-bitbucket.org
-blitzortung.org
-bolt.dropbox.com
-c.root-servers.net
-catalog.gamepass.com
-changelogs.ubuntu.com
-client.dropbox.com
-client.wns.windows.com
-clients1.google.com
-clients2.google.com
-clients3.google.com
-clients4.google.com
-contacts.google.com
-d.dropbox.com
-d.root-servers.net
-dasoertliche.de
-deepl.com
-dell.com
-de.yahoo.com
-discord.com
-discordapp.com
-dhl.de
-download.windowsupdate.com
-duckduckgo.com
-e.root-servers.net
-earth.google.com
-ebay.com
-ebay.de
-ebay.fr
-ebook3000.com
-edition.cnn.com
-f.root-servers.net
-facebook.com
-facebook.de
-facebook.fr
-flightradar24.com
-fonts.google.com
-fonts.googleapis.com
-fonts.gstatic.com
-foto-webcam.eu
-foursquare.com
-g.root-servers.net
-github.com
-github.map.fastly.net
-gmail.com
-google.at
-google.com
-google.de
-google.fr
-google.it
-googleapis.com
-gstatic.com
-h.root-servers.net
-holidaycheck.de
-hornbach.de
-i.root-servers.net
-i.ytimg.com
-IEEE.org
-ibm.com
-icons8.com
-imap.googlemail.com
-install.robertsspaceindustries.com
-ipfs.io
-ipv6.msftconnecttest.com
-j.root-servers.net
-k.root-servers.net
-l.root-servers.net
-launcher2.robertsspaceindustries.com
-licensing.mp.microsoft.com
-live.github.com
-live.thunderbird.net
-livepatch.canonical.com
-login.live.com
-longfiles.com
-m.root-servers.net
-mail.google.com
-map.blitzortung.org
-maps.google.com
-maps.google.de
-maps.google.fr
-microsoft.com
-mozilla.org
-mtalk.google.com
-music.google.com
-news.google.com
-news.google.de
-news.google.fr
-news.url.google.com
-ntp.ubuntu.com
-ogs.google.com
-open.spotify.com
-opera.com
-photos.google.com
-pixabay.com
-play.google.com
-plex.tv
-presence.teams.microsoft.com
-ptbtime1.ptb.de
-ptbtime2.ptb.de
-ptbtime3.ptb.de
-redhat.com
-reichelt.de
-robertsspaceindustries.com
-secure.download.dm.origin.com
-semonkeys.net
-settings.data.microsoft.com
-settings-win.data.microsoft.com
-sites.google.com
-slashdot.org
-speed.cloudflare.com
-speedtest.net
-ssl.gstatic.com
-stackoverflow.com
-start.thunderbird.net
-static.nvidiagrid.net
-storage.googleapis.com
-substrate.office.com
-sunnyportal.com
-t-online.de
-t0.gstatic.com
-teams.microsoft.com
-telemetry.dropbox.com
-tile-service.weather.microsoft.com
-time.windows.com
-toggl.com
-toom.de
-track.toggl.com
-translate.google.de
-twitter.com
-twitter.de
-ubuntu.com
-update.googleapis.com
-wetter.com
-wttr.in
-www.apple.com
-www.arte.tv
-www.bbc.co.uk
-www.bild.de
-www.booking.com
-www.cdc.gov
-www.dropbox.com
-www.ecosia.org
-www.etsy.com
-www.expedia.com
-www.fleschutz.de
-www.focus.de
-www.foto-webcam.eu
-www.golem.de
-www.google.com
-www.googleapis.com
-www.gstatic.com
-www.heise.de
-www.hulu.com
-www.instagram.com
-www.msn.com
-www.nasa.gov
-www.netflix.com
-www.nytimes.com
-www.paypal.com
-www.redbull.com
-www.schneier.com
-www.techstage.de
-www.tiktok.com
-www.ufainc.com
-www.walmart.com
-www.whatsapp.com
-www.whitehouse.gov
-www.windy.com
-www.wikipedia.at
-www.wikipedia.de
-www.wikipedia.fr
-www.wikipedia.org
-www.wired.com
-www.youtube.com
-www.zdf.de

Data/popular-git-repos.csv

@@ -1,29 +0,0 @@
-FOLDERNAME,        CATEGORY,           BRANCH,  FULL,   URL
-base256unicode,    dev tool,           main,    no,     "git@github.com:fleschutz/base256unicode.git"
-bazel,             build tool,         master,  no,     "git@github.com:bazelbuild/bazel.git"
-cmake,             build tool,         master,  no,     "git@github.com:Kitware/CMake.git"
-cmatrix,           CLI fun,            master,  no,     "git@github.com:abishekvashok/cmatrix.git"
-cmark,             tool,               master,  no,     "git@github.com:commonmark/cmark.git"
-CWTS,              dev tool,           main,    no,     "git@github.com:fleschutz/CWTS.git"
-elasticsearch,     search tool,        main,    no,     "git@github.com:elastic/elasticsearch.git"
-kubo,              file sharing tool,  master,  no,     "git@github.com:ipfs/kubo.git"
-grafana,           visualization tool, main,    no,     "git@github.com:grafana/grafana.git"
-jhead,		   EXIF tool,          master,  no,     "git@github.com:Matthias-Wandel/jhead"
-leon,              personal assistant, master,  no,     "git@github.com:leon-ai/leon.git"
-llvm,              compiler,           main,    no,     "git@github.com:llvm/llvm-project.git"
-LSS,               math tool,          main,    no,     "git@github.com:fleschutz/LSS.git"
-ninja,             build tool,         master,  no,     "git@github.com:ninja-build/ninja.git"
-opencv,            lib,                master,  no,     "git@github.com:opencv/opencv.git"
-operating-systems, collection,         main,    no,     "git@github.com:fleschutz/operating-systems.git"
-papers,            collection,         main,    no,     "git@github.com:fleschutz/papers.git"
-PowerShell,        collection,         master,  no,     "git@github.com:fleschutz/PowerShell.git"
-pwsh,              shell,              master,  no,     "git@github.com:PowerShell/PowerShell.git"
-protobuf,          dev,                main,    no,     "git@github.com:protocolbuffers/protobuf.git"
-rust,              compiler,           master,  no,     "git@github.com:rust-lang/rust.git"
-smartmontools,     SSD/HDD tool,       master,  no,     "git@github.com:smartmontools/smartmontools.git"
-talk2windows,      tool,               main,    no,     "git@github.com:fleschutz/talk2windows.git"
-tensorflow,        tool,               master,  no,     "git@github.com:tensorflow/tensorflow.git"
-terminal,          desktop tool,       main,    no,     "git@github.com:microsoft/terminal.git"
-tinycc,            compiler,           mob,     no,     "git@github.com:TinyCC/tinycc.git"
-voice2json,        tool,               master,  no,     "git@github.com:synesthesiam/voice2json.git"
-zfs,               tool,               master,  no,     "git@github.com:openzfs/zfs.git"

Data/powershell-scripts/ReadMe.md

@@ -1,133 +0,0 @@
-## Summary
-How do I create packages? See https://docs.chocolatey.org/en-us/create/create-packages
-
-If you are submitting packages to the community feed (https://community.chocolatey.org)
-always try to ensure you have read, understood and adhere to the create
-packages wiki link above.
-
-## Automatic Packaging Updates?
-Consider making this package an automatic package, for the best
-maintainability over time. Read up at https://docs.chocolatey.org/en-us/create/automatic-packages
-
-## Shim Generation
-Any executables you include in the package or download (but don't call
-install against using the built-in functions) will be automatically shimmed.
-
-This means those executables will automatically be included on the path.
-Shim generation runs whether the package is self-contained or uses automation
-scripts.
-
-By default, these are considered console applications.
-
-If the application is a GUI, you should create an empty file next to the exe
-named 'name.exe.gui' e.g. 'bob.exe' would need a file named 'bob.exe.gui'.
-See https://docs.chocolatey.org/en-us/create/create-packages#how-do-i-set-up-shims-for-applications-that-have-a-gui
-
-If you want to ignore the executable, create an empty file next to the exe
-named 'name.exe.ignore' e.g. 'bob.exe' would need a file named
-'bob.exe.ignore'.
-See https://docs.chocolatey.org/en-us/create/create-packages#how-do-i-exclude-executables-from-getting-shims
-
-## Self-Contained?
-If you have a self-contained package, you can remove the automation scripts
-entirely and just include the executables, they will automatically get shimmed,
-which puts them on the path. Ensure you have the legal right to distribute
-the application though. See https://docs.chocolatey.org/en-us/information/legal.
-
-You should read up on the Shim Generation section to familiarize yourself
-on what to do with GUI applications and/or ignoring shims.
-
-## Automation Scripts
-You have a powerful use of Chocolatey, as you are using PowerShell. So you
-can do just about anything you need. Choco has some very handy built-in
-functions that you can use, these are sometimes called the helpers.
-
-### Built-In Functions
-https://docs.chocolatey.org/en-us/create/functions
-
-A note about a couple:
-* Get-ToolsLocation - used to get you the 'tools' root, which by default is set to 'c:\tools', not the chocolateyInstall bin folder - see https://docs.chocolatey.org/en-us/create/functions/get-toolslocation
-* Install-BinFile - used for non-exe files - executables are automatically shimmed... - see https://docs.chocolatey.org/en-us/create/functions/install-binfile
-* Uninstall-BinFile - used for non-exe files - executables are automatically shimmed - see https://docs.chocolatey.org/en-us/create/functions/uninstall-binfile
-
-### Getting package specific information
-Use the package parameters pattern - see https://docs.chocolatey.org/en-us/guides/create/parse-packageparameters-argument
-
-### Need to mount an ISO?
-https://docs.chocolatey.org/en-us/guides/create/mount-an-iso-in-chocolatey-package
-
-### Environment Variables
-Chocolatey makes a number of environment variables available (You can access any of these with $env:TheVariableNameBelow):
-
- * TEMP/TMP - Overridden to the CacheLocation, but may be the same as the original TEMP folder
- * ChocolateyInstall - Top level folder where Chocolatey is installed
- * ChocolateyPackageName - The name of the package, equivalent to the `<id />` field in the nuspec (0.9.9+)
- * ChocolateyPackageTitle - The title of the package, equivalent to the `<title />` field in the nuspec (0.10.1+)
- * ChocolateyPackageVersion - The version of the package, equivalent to the `<version />` field in the nuspec (0.9.9+)
- * ChocolateyPackageFolder - The top level location of the package folder  - the folder where Chocolatey has downloaded and extracted the NuGet package, typically `C:\ProgramData\chocolatey\lib\packageName`.
-
-#### Advanced Environment Variables
-The following are more advanced settings:
-
- * ChocolateyPackageParameters - Parameters to use with packaging, not the same as install arguments (which are passed directly to the native installer). Based on `--package-parameters`. (0.9.8.22+)
- * CHOCOLATEY_VERSION - The version of Choco you normally see. Use if you are 'lighting' things up based on choco version. (0.9.9+) - Otherwise take a dependency on the specific version you need.
- * ChocolateyForceX86 = If available and set to 'true', then user has requested 32bit version. (0.9.9+) - Automatically handled in built in Choco functions.
- * OS_PLATFORM - Like Windows, OSX, Linux. (0.9.9+)
- * OS_VERSION - The version of OS, like 6.1 something something for Windows. (0.9.9+)
- * OS_NAME - The reported name of the OS. (0.9.9+)
- * USER_NAME = The user name (0.10.6+)
- * USER_DOMAIN = The user domain name (could also be local computer name) (0.10.6+)
- * IS_PROCESSELEVATED = Is the process elevated? (0.9.9+)
- * IS_SYSTEM = Is the user the system account? (0.10.6+)
- * IS_REMOTEDESKTOP = Is the user in a terminal services session? (0.10.6+)
- * ChocolateyToolsLocation - formerly 'ChocolateyBinRoot' ('ChocolateyBinRoot' will be removed with Chocolatey v2.0.0), this is where tools being installed outside of Chocolatey packaging will go. (0.9.10+)
-
-#### Set By Options and Configuration
-Some environment variables are set based on options that are passed, configuration and/or features that are turned on:
-
- * ChocolateyEnvironmentDebug - Was `--debug` passed? If using the built-in PowerShell host, this is always true (but only logs debug messages to console if `--debug` was passed) (0.9.10+)
- * ChocolateyEnvironmentVerbose - Was `--verbose` passed? If using the built-in PowerShell host, this is always true (but only logs verbose messages to console if `--verbose` was passed). (0.9.10+)
- * ChocolateyExitOnRebootDetected - Are we exiting on a detected reboot? Set by ` --exit-when-reboot-detected`  or the feature `exitOnRebootDetected` (0.11.0+)
- * ChocolateyForce - Was `--force` passed? (0.9.10+)
- * ChocolateyForceX86 - Was `-x86` passed? (CHECK)
- * ChocolateyRequestTimeout - How long before a web request will time out. Set by config `webRequestTimeoutSeconds` (CHECK)
- * ChocolateyResponseTimeout - How long to wait for a download to complete? Set by config `commandExecutionTimeoutSeconds` (CHECK)
- * ChocolateyPowerShellHost - Are we using the built-in PowerShell host? Set by `--use-system-powershell` or the feature `powershellHost` (0.9.10+)
-
-#### Business Edition Variables
-
- * ChocolateyInstallArgumentsSensitive - Encrypted arguments passed from command line `--install-arguments-sensitive` that are not logged anywhere. (0.10.1+ and licensed editions 1.6.0+)
- * ChocolateyPackageParametersSensitive - Package parameters passed from command line `--package-parameters-senstivite` that are not logged anywhere.  (0.10.1+ and licensed editions 1.6.0+)
- * ChocolateyLicensedVersion - What version is the licensed edition on?
- * ChocolateyLicenseType - What edition / type of the licensed edition is installed?
- * USER_CONTEXT - The original user context - different when self-service is used (Licensed v1.10.0+)
-
-#### Experimental Environment Variables
-The following are experimental or use not recommended:
-
- * OS_IS64BIT = This may not return correctly - it may depend on the process the app is running under (0.9.9+)
- * CHOCOLATEY_VERSION_PRODUCT = the version of Choco that may match CHOCOLATEY_VERSION but may be different (0.9.9+) - based on git describe
- * IS_ADMIN = Is the user an administrator? But doesn't tell you if the process is elevated. (0.9.9+)
- * IS_REMOTE = Is the user in a remote session? (0.10.6+)
-
-#### Not Useful Or Anti-Pattern If Used
-
- * ChocolateyInstallOverride = Not for use in package automation scripts. Based on `--override-arguments` being passed. (0.9.9+)
- * ChocolateyInstallArguments = The installer arguments meant for the native installer. You should use chocolateyPackageParameters instead. Based on `--install-arguments` being passed. (0.9.9+)
- * ChocolateyIgnoreChecksums - Was `--ignore-checksums` passed or the feature `checksumFiles` turned off? (0.9.9.9+)
- * ChocolateyAllowEmptyChecksums - Was `--allow-empty-checksums` passed or the feature `allowEmptyChecksums` turned on? (0.10.0+)
- * ChocolateyAllowEmptyChecksumsSecure - Was `--allow-empty-checksums-secure` passed or the feature `allowEmptyChecksumsSecure` turned on? (0.10.0+)
- * ChocolateyChecksum32 - Was `--download-checksum` passed? (0.10.0+)
- * ChocolateyChecksumType32 - Was `--download-checksum-type` passed? (0.10.0+)
- * ChocolateyChecksum64 - Was `--download-checksum-x64` passed? (0.10.0)+
- * ChocolateyChecksumType64 - Was `--download-checksum-type-x64` passed? (0.10.0)+
- * ChocolateyPackageExitCode - The exit code of the script that just ran - usually set by `Set-PowerShellExitCode` (CHECK)
- * ChocolateyLastPathUpdate - Set by Chocolatey as part of install, but not used for anything in particular in packaging.
- * ChocolateyProxyLocation - The explicit proxy location as set in the configuration `proxy` (0.9.9.9+)
- * ChocolateyDownloadCache - Use available download cache? Set by `--skip-download-cache`, `--use-download-cache`, or feature `downloadCache` (0.9.10+ and licensed editions 1.1.0+)
- * ChocolateyProxyBypassList - Explicitly set locations to ignore in configuration `proxyBypassList` (0.10.4+)
- * ChocolateyProxyBypassOnLocal - Should the proxy bypass on local connections? Set based on configuration `proxyBypassOnLocal` (0.10.4+)
- * http_proxy - Set by original `http_proxy` passthrough, or same as `ChocolateyProxyLocation` if explicitly set. (0.10.4+)
- * https_proxy - Set by original `https_proxy` passthrough, or same as `ChocolateyProxyLocation` if explicitly set. (0.10.4+)
- * no_proxy- Set by original `no_proxy` passthrough, or same as `ChocolateyProxyBypassList` if explicitly set. (0.10.4+)
-

Data/powershell-scripts/_TODO.txt

@@ -1,131 +0,0 @@
-TODO
-
-1. Determine Package Use:
-
- Organization? Internal Use? - You are not subject to distribution
-  rights when you keep everything internal. Put the binaries directly
-  into the tools directory (as long as total nupkg size is under 1GB).
-  When bigger, look to use from a share or download binaries from an
-  internal location. Embedded binaries makes for the most reliable use
-  of Chocolatey. Use `$fileLocation` (`$file`/`$file64`) and
-  `Install-ChocolateyInstallPackage`/`Get-ChocolateyUnzip` in
-  tools\chocolateyInstall.ps1.
-
-  You can also choose to download from internal urls, see the next
-  section, but ignore whether you have distribution rights or not, it
-  doesn't apply. Under no circumstances should download from the
-  internet, it is completely unreliable. See
-  https://docs.chocolatey.org/en-us/community-repository/community-packages-disclaimer
-  to understand the limitations of a publicly available repository.
-
- Community Repository?
-  Have Distribution Rights?
-    If you are the software vendor OR the software EXPLICITLY allows
-    redistribution and the total nupkg size will be under 200MB, you
-    have the option to embed the binaries directly into the package to
-    provide the most reliable install experience. Put the binaries
-    directly into the tools folder, use `$fileLocation` (`$file`/
-    `$file64`) and `Install-ChocolateyInstallPackage`/
-    `Get-ChocolateyUnzip` in tools\chocolateyInstall.ps1. Additionally,
-    fill out the LICENSE and VERIFICATION file (see 3 below and those
-    files for specifics).
-
-    NOTE: You can choose to download binaries at runtime, but be sure
-     the download location will remain stable. See the next section.
-
-  Do Not Have Distribution Rights?
-    - Note: Packages built this way cannot be 100% reliable, but it's a
-      constraint of publicly available packages and there is little
-      that can be done to change that. See
-      https://docs.chocolatey.org/en-us/community-repository/community-packages-disclaimer
-      to better understand the limitations of a publicly available
-      repository.
-    Download Location is Publicly Available?
-      You will need to download the runtime files from their official
-      location at runtime. Use `$url`/`$url64` and
-      `Install-ChocolateyPackage`/`Install-ChocolateyZipPackage` in
-      tools\chocolateyInstall.ps1.
-    Download Location is Not Publicly Available?
-      Stop here, you can't push this to the community repository. You
-      can ask the vendor for permission to embed, then include a PDF of
-      that signed permission directly in the package. Otherwise you
-      will need to seek alternate locations to non-publicly host the
-      package.
-    Download Location Is Same For All Versions?
-      You still need to point to those urls, but you may wish to set up
-      something like Automatic Updater (AU) so that when a new version
-      of the software becomes available, the new package version
-      automatically gets pushed up to the community repository. See
-      https://docs.chocolatey.org/en-us/create/automatic-packages#automatic-updater-au
-
-2. Determine Package Type:
-
-- Installer Package - contains an installer (everything in template is
-  geared towards this type of package)
-- Zip Package - downloads or embeds and unpacks archives, may unpack
-  and run an installer using `Install-ChocolateyInstallPackage` as a
-  secondary step.
-- Portable Package - Contains runtime binaries (or unpacks them as a
-  zip package) - cannot require administrative permissions to install
-  or use
-- Config Package - sets config like files, registry keys, etc
-- Extension Package - Packages that add PowerShell functions to
-  Chocolatey - https://docs.chocolatey.org/en-us/features/extensions
-- Template Package - Packages that add templates like this for `choco
-  new -t=name` - https://docs.chocolatey.org/en-us/guides/create/create-custom-package-templates
-- Other - there are other types of packages as well, these are the main
-  package types seen in the wild
-
-3. Fill out the package contents:
-
-- tools\chocolateyBeforeModify.ps1 - remove if you have no processes
-  or services to shut down before upgrade/uninstall
-- tools\LICENSE.txt / tools\VERIFICATION.txt - Remove if you are not
-  embedding binaries. Keep and fill out if you are embedding binaries
-  in the package AND pushing to the community repository, even if you
-  are the author of software. The file becomes easier to fill out
-  (does not require changes each version) if you are the software
-  vendor. If you are building packages for internal use (organization,
-  etc), you don't need these files as you are not subject to
-  distribution rights internally.
-- tools\chocolateyUninstall.ps1 - remove if autouninstaller can
-  automatically uninstall and you have nothing additional to do during
-  uninstall
-- Readme.txt - delete this file once you have read over and used
-  anything you've needed from here
-- nuspec - fill this out, then clean out all the comments (you may wish
-  to leave the headers for the package vs software metadata)
-- tools\chocolateyInstall.ps1 - instructions in next section.
-
-4. ChocolateyInstall.ps1:
-
-- For embedded binaries - use `$fileLocation` (`$file`/`$file64`) and
-  `Install-ChocolateyInstallPackage`/ `Get-ChocolateyUnzip`.
-- Downloading binaries at runtime - use `$url`/`$url64` and
-  `Install-ChocolateyPackage` / `Install-ChocolateyZipPackage`.
-- Other needs (creating files, setting registry keys), use regular
-  PowerShell to do so or see if there is a function already defined:
-  https://docs.chocolatey.org/en-us/create/functions
-- There may also be functions available in extension packages, see
-  https://community.chocolatey.org/packages?q=id%3A.extension for examples and
-  availability.
-- Clean out the comments and sections you are not using.
-
-5. Test the package to ensure install/uninstall work appropriately.
- There is a test environment you can use for this -
- https://github.com/chocolatey/chocolatey-test-environment
-
-6. Learn more about Chocolatey packaging - go through the workshop at
- https://github.com/chocolatey/chocolatey-workshop
- You will learn about
- - General packaging
- - Customizing package behavior at runtime (package parameters)
- - Extension packages
- - Custom packaging templates
- - Setting up an internal Chocolatey.Server repository
- - Adding and using internal repositories
- - Reporting
- - Advanced packaging techniques when installers are not friendly to
-   automation
-
-7. Delete this file.

Data/powershell-scripts/powershell-scripts.nuspec

@@ -1,51 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Do not remove this test for UTF-8: if “Ω” doesn’t appear as greek uppercase omega letter enclosed in quotation marks, you should use an editor that supports UTF-8, not this one. -->
-<package xmlns="http://schemas.microsoft.com/packaging/2015/06/nuspec.xsd">
-  <metadata>
-    <!-- == PACKAGE SPECIFIC SECTION == -->
-    <!-- This section is about this package, although id and version have ties back to the software -->
-    <!-- id is lowercase and if you want a good separator for words, use '-', not '.'. Dots are only acceptable as suffixes for certain types of packages, e.g. .install, .portable, .extension, .template -->
-    <!-- If the software is cross-platform, attempt to use the same id as the debian/rpm package(s) if possible. -->
-    <id>powershell-scripts</id>
-    <!-- version should MATCH as closely as possible with the underlying software -->
-    <!-- Is the version a prerelease of a version? https://docs.nuget.org/create/versioning#creating-prerelease-packages -->
-    <!-- Note that unstable versions like 0.0.1 can be considered a released version, but it's possible that one can release a 0.0.1-beta before you release a 0.0.1 version. If the version number is final, that is considered a released version and not a prerelease. -->
-    <version>0.4</version>
-    <packageSourceUrl>https://github.com/fleschutz/PowerShell</packageSourceUrl>
-    <!-- owners is a poor name for maintainers of the package. It sticks around by this name for compatibility reasons. It basically means you. -->
-    <owners>Markus Fleschutz</owners>
-    <!-- ============================== -->
-
-    <!-- == SOFTWARE SPECIFIC SECTION == -->
-    <!-- This section is about the software itself -->
-    <title>powershell-scripts</title>
-    <authors>Markus Fleschutz</authors>
-    <!-- projectUrl is required for the community feed -->
-    <projectUrl>https://github.com/fleschutz/PowerShell</projectUrl>
-    <!-- There are a number of CDN Services that can be used for hosting the Icon for a package. More information can be found here: https://docs.chocolatey.org/en-us/create/create-packages#package-icon-guidelines -->
-    <!-- <copyright>Year Software Vendor</copyright> -->
-    <!-- If there is a license Url available, it is required for the community feed -->
-    <licenseUrl>https://github.com/fleschutz/PowerShell/blob/master/LICENSE</licenseUrl>
-    <requireLicenseAcceptance>false</requireLicenseAcceptance>
-    <projectSourceUrl>https://github.com/fleschutz/PowerShell</projectSourceUrl>
-    <!--<docsUrl>At what url are the software docs located?</docsUrl>-->
-    <!--<mailingListUrl></mailingListUrl>-->
-    <bugTrackerUrl>https://github.com/fleschutz/PowerShell/issues</bugTrackerUrl>
-    <tags>powershell-scripts PowerShell Scripts collection</tags>
-    <summary>Mega Collection of PowerShell Scripts</summary>
-    <description>This collection provides more than 250 useful and cross-platform PowerShell scripts in the Scripts subfolder - to be used by command-line interface (CLI), for remote control (e.g. via SSH), by context menu, by voice control (see also repo talk2windows), by automation software like Jenkins, automatically as daily tasks, or simply to learn PowerShell.</description>
-    <releaseNotes>0.4 Release</releaseNotes>
-    <!-- =============================== -->
-   
-    <dependencies>
-      <dependency id="chocolatey-core.extension" version="1.1.0" />
-    </dependencies>
-    <!--<provides>NOT YET IMPLEMENTED</provides>-->
-    <!--<conflicts>NOT YET IMPLEMENTED</conflicts>-->
-    <!--<replaces>NOT YET IMPLEMENTED</replaces>-->
-  </metadata>
-  <files>
-    <!-- this section controls what actually gets packaged into the Chocolatey package -->
-    <file src="tools\**" target="tools" />
-  </files>
-</package>

Data/powershell-scripts/tools/LICENSE.txt

@@ -1,11 +0,0 @@
-
-Note: Include this file if including binaries you have the right to distribute. 
-Otherwise delete. this file.
-
-===DELETE ABOVE THIS LINE AND THIS LINE===
-
-From: <insert applicable license url here>
-
-LICENSE
-
-<Insert License Here>

Data/powershell-scripts/tools/VERIFICATION.txt

@@ -1,13 +0,0 @@
-
-Note: Include this file if including binaries you have the right to distribute. 
-Otherwise delete. this file. If you are the software author, you can change this
-mention you are the author of the software.
-
-===DELETE ABOVE THIS LINE AND THIS LINE===
-
-VERIFICATION
-Verification is intended to assist the Chocolatey moderators and community
-in verifying that this package's contents are trustworthy.
- 
-<Include details of how to verify checksum contents>
-<If software vendor, explain that here - checksum verification instructions are optional>

Data/powershell-scripts/tools/chocolateybeforemodify.ps1

@@ -1,9 +0,0 @@
-# This runs in 0.9.10+ before upgrade and uninstall.
-# Use this file to do things like stop services prior to upgrade or uninstall.
-# NOTE: It is an anti-pattern to call chocolateyUninstall.ps1 from here. If you
-#  need to uninstall an MSI prior to upgrade, put the functionality in this
-#  file without calling the uninstall script. Make it idempotent in the
-#  uninstall script so that it doesn't fail when it is already uninstalled.
-# NOTE: For upgrades - like the uninstall script, this script always runs from 
-#  the currently installed version, not from the new upgraded package version.
-

Data/powershell-scripts/tools/chocolateyinstall.ps1

@@ -1,42 +0,0 @@
-
-$ErrorActionPreference = 'Stop';
-$toolsDir   = "$(Split-Path -parent $MyInvocation.MyCommand.Definition)"
-$url        = ''
-$url64      = ''
-
-$packageArgs = @{
-  packageName   = $env:ChocolateyPackageName
-  unzipLocation = $toolsDir
-  fileType      = 'EXE'
-  url           = $url
-  url64bit      = $url64
-
-  softwareName  = 'powershell-scripts*'
-
-  checksum      = ''
-  checksumType  = 'sha256'
-  checksum64    = ''
-  checksumType64= 'sha256'
-
-  silentArgs    = "/qn /norestart /l*v `"$($env:TEMP)\$($packageName).$($env:chocolateyPackageVersion).MsiInstall.log`""
-  validExitCodes= @(0, 3010, 1641)
-}
-
-Install-ChocolateyPackage @packageArgs
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

Data/powershell-scripts/tools/chocolateyuninstall.ps1

@@ -1,83 +0,0 @@
-# IMPORTANT: Before releasing this package, copy/paste the next 2 lines into PowerShell to remove all comments from this file:
-#   $f='c:\path\to\thisFile.ps1'
-#   gc $f | ? {$_ -notmatch "^\s*#"} | % {$_ -replace '(^.*?)\s*?[^``]#.*','$1'} | Out-File $f+".~" -en utf8; mv -fo $f+".~" $f
-
-## NOTE: In 80-90% of the cases (95% with licensed versions due to Package Synchronizer and other enhancements),
-## AutoUninstaller should be able to detect and handle registry uninstalls without a chocolateyUninstall.ps1.
-## See https://docs.chocolatey.org/en-us/choco/commands/uninstall
-## and https://docs.chocolatey.org/en-us/create/functions/uninstall-chocolateypackage
-
-## If this is an MSI, ensure 'softwareName' is appropriate, then clean up comments and you are done.
-## If this is an exe, change fileType, silentArgs, and validExitCodes
-
-$ErrorActionPreference = 'Stop'; # stop on all errors
-$packageArgs = @{
-  packageName   = $env:ChocolateyPackageName
-  softwareName  = 'powershell-scripts*'  #part or all of the Display Name as you see it in Programs and Features. It should be enough to be unique
-  fileType      = 'EXE_MSI_OR_MSU' #only one of these: MSI or EXE (ignore MSU for now)
-  # MSI
-  silentArgs    = "/qn /norestart"
-  validExitCodes= @(0, 3010, 1605, 1614, 1641) # https://msdn.microsoft.com/en-us/library/aa376931(v=vs.85).aspx
-  # OTHERS
-  # Uncomment matching EXE type (sorted by most to least common)
-  #silentArgs   = '/S'           # NSIS
-  #silentArgs   = '/VERYSILENT /SUPPRESSMSGBOXES /NORESTART /SP-' # Inno Setup
-  #silentArgs   = '/s'           # InstallShield
-  #silentArgs   = '/s /v"/qn"'   # InstallShield with MSI
-  #silentArgs   = '/s'           # Wise InstallMaster
-  #silentArgs   = '-s'           # Squirrel
-  #silentArgs   = '-q'           # Install4j
-  #silentArgs   = '-s -u'        # Ghost
-  # Note that some installers, in addition to the silentArgs above, may also need assistance of AHK to achieve silence.
-  #silentArgs   = ''             # none; make silent with input macro script like AutoHotKey (AHK)
-                                 #       https://community.chocolatey.org/packages/autohotkey.portable
-  #validExitCodes= @(0) #please insert other valid exit codes here
-}
-
-# Get-UninstallRegistryKey is new to 0.9.10, if supporting 0.9.9.x and below,
-# take a dependency on "chocolatey-core.extension" in your nuspec file.
-# This is only a fuzzy search if $softwareName includes '*'. Otherwise it is
-# exact. In the case of versions in key names, we recommend removing the version
-# and using '*'.
-[array]$key = Get-UninstallRegistryKey -SoftwareName $packageArgs['softwareName']
-
-if ($key.Count -eq 1) {
-  $key | % {
-    $packageArgs['file'] = "$($_.UninstallString)" #NOTE: You may need to split this if it contains spaces, see below
-
-    if ($packageArgs['fileType'] -eq 'MSI') {
-      # The Product Code GUID is all that should be passed for MSI, and very
-      # FIRST, because it comes directly after /x, which is already set in the
-      # Uninstall-ChocolateyPackage msiargs (facepalm).
-      $packageArgs['silentArgs'] = "$($_.PSChildName) $($packageArgs['silentArgs'])"
-
-      # Don't pass anything for file, it is ignored for msi (facepalm number 2)
-      # Alternatively if you need to pass a path to an msi, determine that and
-      # use it instead of the above in silentArgs, still very first
-      $packageArgs['file'] = ''
-    } else {
-      # NOTES:
-      # - You probably will need to sanitize $packageArgs['file'] as it comes from the registry and could be in a variety of fun but unusable formats
-      # - Split args from exe in $packageArgs['file'] and pass those args through $packageArgs['silentArgs'] or ignore them
-      # - Ensure you don't pass double quotes in $file (aka $packageArgs['file']) - otherwise you will get "Illegal characters in path when you attempt to run this"
-      # - Review the code for auto-uninstaller for all of the fun things it does in sanitizing - https://github.com/chocolatey/choco/blob/bfe351b7d10c798014efe4bfbb100b171db25099/src/chocolatey/infrastructure.app/services/AutomaticUninstallerService.cs#L142-L192
-    }
-
-    Uninstall-ChocolateyPackage @packageArgs
-  }
-} elseif ($key.Count -eq 0) {
-  Write-Warning "$packageName has already been uninstalled by other means."
-} elseif ($key.Count -gt 1) {
-  Write-Warning "$($key.Count) matches found!"
-  Write-Warning "To prevent accidental data loss, no programs will be uninstalled."
-  Write-Warning "Please alert package maintainer the following keys were matched:"
-  $key | % {Write-Warning "- $($_.DisplayName)"}
-}
-
-## OTHER POWERSHELL FUNCTIONS
-## https://docs.chocolatey.org/en-us/create/functions
-#Uninstall-ChocolateyZipPackage $packageName # Only necessary if you did not unpack to package directory - see https://docs.chocolatey.org/en-us/create/functions/uninstall-chocolateyzippackage
-#Uninstall-ChocolateyEnvironmentVariable # 0.9.10+ - https://docs.chocolatey.org/en-us/create/functions/uninstall-chocolateyenvironmentvariable
-#Uninstall-BinFile # Only needed if you used Install-BinFile - see https://docs.chocolatey.org/en-us/create/functions/uninstall-binfile
-## Remove any shortcuts you added in the install script.
-

Data/public-dns-servers.csv

@@ -1,26 +0,0 @@
-PROVIDER,                                      IPv4_PRI,     IPv4_SEC
-"AdGuard DNS (Cyprus)",                        94.140.14.14, 94.140.15.15
-"CleanBrowsing",                               185.228.168.9, 185.228.169.9
-"Cloudflare Public DNS (USA, standard)",       1.1.1.1,      1.0.0.1
-"Cloudflare Public DNS (with malware blocklist)",         1.1.1.2,      1.0.0.2
-"Cloudflare Public DNS (with malware+adult blocklist)",   1.1.1.3,      1.0.0.3
-"Control D (Canada)",                          76.76.2.0,    76.76.10.0
-"DNS0.eu (standard)",                          193.110.81.0, 185.253.5.0
-"DNS0.eu (for kids)",                          193.110.81.1, 185.253.5.1
-"DNS0.eu (zero)",                              193.110.81.9, 185.253.5.9
-"DNS.WATCH (Germany)",                         84.200.69.80, 84.200.70.40
-"Google Public DNS (USA)",                     8.8.8.8,      8.8.4.4
-"Level3 one",                                  4.2.2.1,      4.2.2.1
-"Level3 two",                                  4.2.2.2,      4.2.2.2 
-"Level3 three",                                4.2.2.3,      4.2.2.3
-"Level3 four",                                 4.2.2.4,      4.2.2.4
-"Level3 five",                                 4.2.2.5,      4.2.2.5
-"Level3 six",                                  4.2.2.6,      4.2.2.6
-"OpenDNS (basic)",                             208.67.222.222, 208.67.220.220 
-"OpenDNS (family shield)",                     208.67.222.123, 208.67.220.123 
-"OpenNIC Project",                             94.247.43.254, 94.247.43.254
-"Quad9 (with malware blocklist, with DNSSEC)", 9.9.9.9,      149.112.112.112
-"Quad9 (no malware blocklist, no DNSSEC)",     9.9.9.10,     9.9.9.10
-"Quad9 (with malware blocklist, with DNSSEC, with EDNS)", 9.9.9.11, 9.9.9.11
-"Quad9 (with malware blocklist, with DNSSEC, NXDOMAIN only)", 9.9.9.12, 9.9.9.12 
-"Verisign Public DNS (USA)",                   64.6.64.6,    64.6.65.6

Data/quotes.csv

@@ -1,48 +0,0 @@
-CATEGORY,AUTHOR,QUOTE
-IQ,Thomas Edison,"Genius is one percent inspiration and ninety-nine percent perspiration."
-Life,Abraham Lincoln,"In the end, it's not the years in your life that count. It's the life in your years."
-Life,Albert Einstein,"Only a life lived for others is a life worthwhile."
-Life,Marilyn Monroe,"Keep smiling, because life is a beautiful thing and there's so much to smile about."
-Life,James M. Barrie,"Life is a long lesson in humility."
-Life,Bob Marley,"Love the life you live. Live the life you love."
-Life,Ray Bradbury,"Life is trying things to see if they work."
-Life,Helen Keller,"Life is either a daring adventure or nothing at all."
-Life,John Lennon,"Life is what happens when you're busy making other plans."
-Life,Jonathan Swift,"May you live all the days of your life."
-Misc,Abraham Lincoln,"The best thing about the future is that it only comes one day at a time."
-Misc,Albert Einstein,"Learn from yesterday, live for today, hope for tomorrow."
-Misc,Anne Frank,"Whoever is happy will make others happy too."
-Misc,Aristotle,"It is during our darkest moments that we must focus to see the light."
-Misc,Benjamin Franklin,"Tell me and I forget. Teach me and I remember. Involve me and I learn."
-Misc,Bruce Lee,"Mistakes are always forgivable, if one has the courage to admit them."
-Misc,Eleanor Roosevelt,"The future belongs to those who believe in the beauty of their dreams."
-Misc,Johann Wolfgang von Goethe,"Difficulties increase the nearer we get to the goal."
-Misc,Michelangelo,"Faith in oneself is the best and safest course."
-Misc,Sophocles,"It takes both sunshine and rain to make a rainbow."
-Misc,Mahatma Gandhi,"We must become the change we want to see."
-Misc,Johann Wolfgang von Goethe,"Knowing is not enough; we must apply!"
-Misc,Immanuel Kant,"Science is organized knowledge. Wisdom is organized life."
-Misc,Indira Gandhi,"You can't shake hands with a clenched fist."
-Misc,Pierre Auguste Renoir,"The pain passes, but the beauty remains."
-Misc,Heraclitus,"All is flux; nothing stays still."
-Misc,Japanese proverb,"The day you decide to do it is your lucky day."
-Misc,Epictetus,"We have two ears and one mouth so that we can listen twice as much as we speak."
-Misc,Cervantes,"Be slow of tongue and quick of eye."
-Misc,Nelson Mandela,"The greatest glory in living lies not in never falling, but in rising every time we fall."
-Misc,Mother Teresa,"Spread love everywhere you go. Let no one ever come to you without leaving happier."
-Misc,Mae West,"You only live once, but if you do it right, once is enough."
-Misc,Hans Christian Andersen,"Life itself is the most wonderful fairy tale."
-Misc,Walt Disney,"The way to get started is to quit talking and begin doing."
-Misc,William Shakespeare,"Having nothing, nothing can he lose."
-Misc,Tony Robbins,"The only impossible journey is the one you never begin."
-Misc,Ralph Waldo Emerson,"Do not go where the path may lead, go instead where there is no path and leave a trail."
-Misc,Margaret Mead,"Always remember that you are absolutely unique. Just like everyone else."
-Misc,J.K. Rowling,"When in doubt go to the library."
-Success,Albert Einstein,"Try not to become a man of success, but rather try to become a man of value."
-Success,Steve Jobs,"If you really look closely, most overnight successes took a long time."
-Success,Oprah Winfrey,"You know you are on the road to success if you would do your job and not be paid for it."
-Success,David Brinkley,"A successful man is one who can lay a firm foundation with the bricks others have thrown at him."
-Success,Estee Lauder,"I never dreamed about success, I worked for it."
-Success,Henry David Thoreau,"Success usually comes to those who are too busy to be looking for it."
-Success,Colin Powell,"There are no secrets to success. It is the result of preparation, hard work, and learning from failure."
-Success,John D. Rockefeller,"The secret of success is to do the common thing uncommonly well."

Data/scripts.csv

@@ -1,293 +0,0 @@
-SCRIPT,DESCRIPTION
-add-firewall-rules.ps1, Adds firewall rules for executables (needs admin rights)
-add-memo.ps1, Adds a memo text
-build-repo.ps1, Builds a Git repository 
-build-repos.ps1, Builds all Git repositories in a folder
-cd-autostart.ps1, Set the working directory to the user's autostart folder
-cd-desktop.ps1, Set the working directory to the user's desktop folder
-cd-docs.ps1, Set the working directory to the user's documents folder
-cd-downloads.ps1, Set the working directory to the user's downloads folder
-cd-dropbox.ps1, Set the working directory to the user's Dropbox folder
-cd-home.ps1, Set the working directory to the user's home folder
-cd-music.ps1, Set the working directory to the user's music folder
-cd-onedrive.ps1, Set the working directory to the user's OneDrive folder
-cd-pics.ps1, Set the working directory to the user's pictures folder
-cd-recycle-bin.ps1, Set the working directory to the user's recycle bin folder
-cd-repos.ps1, Set the working directory to the user's Git repositories folder
-cd-root.ps1, Set the working directory to the root directory (C: on Windows)
-cd-scripts.ps1, Set the working directory to the PowerShell Scripts folder
-cd-ssh.ps1, Set the working directory to the user's SSH folder
-cd-up.ps1, Set the working directory to one directory level up
-cd-up2.ps1, Set the working directory to two directory levels up
-cd-up3.ps1, Set the working directory to three directory levels up
-cd-up4.ps1, Set the working directory to four directory levels up
-cd-videos.ps1, Set the working directory to the user's videos folder
-check-cpu-temp.ps1, Checks the CPU temperature
-check-dns-resolution.ps1, Checks the DNS resolution with frequently used domain names
-check-drive-space.ps1, Checks a drive for free space left
-check-file-system.ps1, Checks the file system of a drive (needs admin rights)
-check-health.ps1, Checks the system health
-check-ipv4-address.ps1, Checks the given IPv4 address for validity
-check-ipv6-address.ps1, Checks the given IPv6 address for validity
-check-mac-address.ps1, Checks the given MAC address for validity
-check-ping.ps1, Checks the ping latency to the internet
-check-subnet-mask.ps1, Checks the given subnet mask for validity
-check-swap-space.ps1, Checks the swap space for free space left
-check-symlinks.ps1, Checks every symlink in a directory tree
-check-weather.ps1, Checks the current weather for critical values
-check-windows-system-files.ps1, Checks the validity of the Windows system files 
-check-xml-file.ps1, Checks the given XML file for validity
-clean-repo.ps1, Cleans the current/given Git repository from untracked files (including submodules)
-clean-repos.ps1, Cleans all Git repositories under the current/given directory from untracked files (including submodules)
-clear-recycle-bin.ps1, Removes the content of the recycle bin folder (can not be undo!)
-clone-repos.ps1, Clones well-known Git repositories
-close-calculator.ps1, Closes the calculator program gracefully
-close-cortana.ps1, Closes Cortana gracefully
-close-file-explorer.ps1, Closes Microsoft File Explorer gracefully
-close-google-chrome.ps1, Closes the Google Chrome Web browser
-close-program.ps1, Closes the given program gracefully
-close-microsoft-edge.ps1, Closes the Microsoft Edge Web browser
-close-microsoft-store.ps1, Closes the Microsoft Store app
-close-mozilla-firefox.ps1, Closes the Mozilla Firefox Web browser 
-close-netflix.ps1, Closes the Netflix application gracefully
-close-onedrive.ps1, Closes Microsoft OneDrive gracefully
-close-serenade.ps1, Closes the Serenade.ai application gracefully
-close-snipping-tool.ps1, Closes the Snipping Tool application gracefully
-close-spotify.ps1, Closes Spotify
-close-system-settings.ps1, Closes the System Settings gracefully
-close-thunderbird.ps1, Closes Mozilla Thunderbird gracefully
-close-vlc.ps1, Closes the VLC media player application
-close-windows-terminal.ps1, Closes the Windows Terminal application
-copy-photos-sorted.ps1, Copy image files sorted by year and month 
-configure-git.ps1, Sets up the Git user configuration
-convert-csv2txt.ps1, Converts the given CSV file into a text list
-convert-mysql2csv.ps1, Converts the MySQL database table to a CSV file
-convert-ps2bat.ps1, Converts PowerShell script(s) to .bat files
-convert-ps2md.ps1, Converts the comment-based help of a PowerShell script to Markdown
-convert-sql2csv.ps1, Converts the SQL database table to a CSV file
-convert-txt2wav.ps1, Converts text into a audio .WAV file
-daily-tasks.sh, Execute PowerShell scripts automatically as daily tasks (Linux only)
-decrypt-file.ps1, Decrypts the given file
-display-time.ps1, Displays the current time for 10 seconds by default
-download-dir.ps1, Downloads a directory tree from the given URL
-download-file.ps1, Downloads a file from the given URL
-edit.ps1, Edits the given file with the built-in text editor
-enable-crash-dumps.ps1, Enables the writing of crash dumps
-enable-god-mode.ps1, Enables the god mode (adds a new icon to the desktop)
-encrypt-file.ps1, Encrypts the given file
-export-to-manuals.ps1, Converts all scripts as manuals                                    
-export-to-serenade.ps1, Converts all scripts to Serenade for voice control
-fetch-repo.ps1, Fetches updates for the current/given Git repository (including submodules)
-fetch-repos.ps1, Fetches updates for all Git repositories under the current/given directory (including submodules)
-get-md5.ps1, Prints the MD5 checksum of the given file
-get-sha1.ps1, Prints the SHA1 checksum of the given file
-get-sha256.ps1, Prints the SHA256 checksum of the given file
-hibernate.ps1, Enables hibernate mode for the local computer (needs admin rights)
-inspect-exe.ps1, Prints basic information of the given executable file
-install-github-cli.ps1, Installs GitHub CLI
-install-google-chrome.ps1, Installs the Google Chrome browser
-install-knot-resolver.ps1, Installs the Knot Resolver (needs admin rights)
-install-signal-cli.ps1, Installs signal-cli from github.com/AsamK/signal-cli
-install-ssh-client.ps1, Installs the SSH client (needs admin rights)
-install-ssh-server.ps1, Installs the SSH server (needs admin rights)
-install-updates.ps1, Installs updates (needs admin rights)
-install-vscode.ps1, Installs Visual Studio Code 
-install-wsl.ps1, Installs Windows Subsystem for Linux (WSL), needs admin rights
-introduce-powershell.ps1, Introduces PowerShell to new users
-list-aliases.ps1, Lists all PowerShell aliases 
-list-anagrams.ps1, Lists all anagrams of the given word
-list-automatic-variables.ps1, Lists the automatic variables of PowerShell 
-list-branches.ps1, Lists all branches in the current/given Git repository 
-list-cheat-sheet.ps1, Lists the PowerShell cheat sheet
-list-city-weather.ps1, Lists the current weather of cities worldwide (east to west)
-list-commits.ps1, Lists all commits in the current/given Git repository 
-list-console-colors.ps1, Lists all console colors
-list-countries.ps1, Lists details of all countries
-list-cli-tools.ps1, Lists available command-line interface (CLI) tools 
-list-clipboard.ps1, Lists the contents of the clipboard
-list-credits.ps1, Shows the credits
-list-crypto-rates.ps1, Lists the current crypto exchange rates 
-list-dir-tree.ps1, Lists the directory tree content 
-list-drives.ps1, Lists all drives
-list-environment-variables.ps1, Lists all environment variables
-list-emojis.ps1, Lists the emojis of Unicode 13.0
-list-empty-dirs.ps1, Lists empty subfolders within the given directory tree
-list-empty-files.ps1, Lists empty files within the given directory tree
-list-files.ps1, Lists all files in the given folder and also in every subfolder
-list-folder.ps1, Lists the folder content 
-list-fritzbox-calls.ps1, Lists the FRITZ!Box calls
-list-fritzbox-devices.ps1, Lists FRITZ!Box's known devices 
-list-hidden-files.ps1, Lists hidden files within the given directory tree
-list-installed-apps.ps1, Lists the installed Windows Store apps
-list-installed-software.ps1, Lists the installed software (except Windows Store apps)
-list-latest-tag.ps1, Lists the latest tag on the current branch in a Git repository
-list-latest-tags.ps1, Lists the latests tags in all Git repositories under the current/given directory 
-list-memos.ps1, Lists the memos at $HOME/Memos.csv
-list-unused-files.ps1, Lists unused files in a directory tree
-list-cmdlets.ps1, Lists the PowerShell cmdlets
-list-earthquakes.ps1, Lists earthquakes with magnitude >= 6.0 for the last 30 days
-list-exchange-rates.ps1, Lists the exchange rates for the given currency 
-list-modules.ps1, Lists the PowerShell modules
-list-mysql-tables.ps1, Lists the MySQL server tables
-list-network-shares.ps1, Lists the network shares of the local computer
-list-news.ps1, Lists the latest news
-list-os-releases.ps1, Lists operating system releases and download URL 
-list-os-updates.ps1, Lists operating system updates
-list-passwords.ps1, Prints a list of random passwords
-list-pins.ps1, Prints a list of random PIN's
-list-printers.ps1, Lists all printer known to the computer
-list-print-jobs.ps1, Lists all jobs of all printers
-list-processes.ps1, Lists the local computer processes
-list-profiles.ps1, Lists your PowerShell profiles
-list-recycle-bin.ps1, Lists the content of the recycle bin folder
-list-scripts.ps1, Lists all PowerShell scripts in this repository
-list-services.ps1, Lists the services on the local computer
-list-sql-tables.ps1, Lists the SQL server tables
-list-submodules.ps1, Lists the submodules of the current/given Git repository
-list-system-info.ps1, Lists system information on the local computer
-list-tags.ps1, Lists all tags in the current/given Git repository 
-list-tasks.ps1, Lists all Windows scheduler tasks
-list-timezone.ps1, Lists the current time zone details
-list-timezones.ps1, Lists all time zones available 
-list-tiobe-index.ps1, Lists the TIOBE index of top programming languages
-list-user-groups.ps1, Lists the user groups on the local computer
-list-voices.ps1, Lists the installed text-to-speech (TTS) voices
-list-weather.ps1, Lists the hourly weather 
-list-workdir.ps1, Lists the current working directory
-locate-city.ps1, Prints the geographic location of the given city
-locate-ipaddress.ps1, Prints the geographic location of the given IP address
-locate-zip-code.ps1, Prints the geographic location of the given zip-code
-make-install.ps1, Installs built executables and libs to the installation directory
-moon.ps1, Prints the current moon phase
-mute-audio.ps1, Mutes the audio device
-open-amazon.ps1, Opens Amazon's website
-open-browser.ps1, Starts the default Web browser
-open-calculator.ps1, Starts the calculator program
-open-c-drive.ps1, Opens the C: drive folder
-open-downloads-folder.ps1, Opens the user's downloads folder
-open-dropbox-folder.ps1, Opens the user's Dropbox folder
-open-email-client.ps1, Starts the default email client
-open-facebook.ps1, Opens Facebook's website
-open-file-explorer.ps1, Opens the File Explorer
-open-fritz-box.ps1, Opens FRITZ!Box's web interface
-open-github.ps1, Opens GitHub's website
-open-google-contacts.ps1, Opens Google Contacts
-open-google-earth.ps1, Opens Google Earth
-open-google-maps.ps1, Opens Google Maps
-open-google-mail.ps1, Opens Google Mail
-open-google-news.ps1, Opens Google News
-open-google-play.ps1, Opens Google Play
-open-google-search.ps1, Opens Google Search
-open-google-translate.ps1, Opens Google Translate
-open-home-folder.ps1, Opens the user's home folder
-open-music-folder.ps1, Opens the user's music folder
-open-microsoft-edge.ps1, Launches the Microsoft Edge Web browser
-open-microsoft-store.ps1, Starts the Microsoft Store app
-open-netflix.ps1, Starts the Netflix app
-open-notepad.ps1, Starts the Notepad app
-open-onedrive-folder.ps1, Opens the user's OneDrive folder 
-open-recycle-bin.ps1, Opens the user's recycle bin folder
-open-repos-folder.ps1, Opens the user's Git repositories folder
-open-snipping-tools.ps1, Opens the Snipping Tool
-open-speed-test.ps1, Opens Cloudflare's speed test
-open-spotify.ps1, Opens the Spotify app
-open-system-settings.ps1, Launches the Windows system settings 
-open-task-manager.ps1, Launches the Task Manager
-open-toggl-track.ps1, Opens Toggl Track
-open-videos-folder.ps1, Opens the user's videos folder
-open-windows-terminal.ps1, Launches Windows Terminal
-open-wikipedia.ps1, Opens Wikipedia's website
-open-youtube.ps1, Opens YouTube.com
-pick-commit.ps1, Cherry-picks a Git commit into multiple branches
-play-beep-sound.ps1, Plays a short beep sound
-play-files.ps1, Plays the given audio files
-play-happy-birthday.ps1, Plays the Happy Birthday song
-play-imperial-march.ps1, Plays the Imperial March (Star Wars)
-play-jingle-bells.ps1, Plays Jingle Bells
-play-mission-impossible.ps1, Plays the Mission Impossible theme
-play-m3u.ps1, Plays the given playlist (M3U file format)
-play-mp3.ps1, Plays the given sound file (MP3 file format)
-play-super-mario.ps1, Plays the Super Mario Intro
-play-tetris-melody.ps1, Plays the Tetris melody
-poweroff.ps1, Halts the local computer (needs admin rights)
-publish-to-ipfs.ps1, Publishes the given files or directory to IPFS
-pull-repo.ps1, Pulls updates for the current/given Git repository (including submodules)
-pull-repos.ps1, Pulls updates for all Git repositories under the current/given directory (including submodules)
-query-smart-data.ps1, Queries the S.M.A.R.T. data of your HDD/SSD's and saves it to the current/given directory
-new-branch.ps1, Creates a new branch in the current/given Git repository 
-new-email.ps1, Starts the default email client to write a new email
-new-qrcode.ps1, Generates a new QR code
-new-script.ps1, Creates a new PowerShell script
-new-shortcut.ps1, Creates a new shortcut file
-new-symlink.ps1, Creates a new symbolic link file
-new-tag.ps1, Creates a new tag in a Git repository 
-new-zipfile.ps1, Creates a new .zip file from a directory
-reboot.ps1, Reboots the local computer (needs admin rights)
-reboot-fritzbox.ps1, Reboots the FRITZ!box device
-remind-me.ps1, Creates a scheduled task that will display a popup message
-remove-empty-dirs.ps1, Removes empty subfolders within the given directory tree
-remove-print-jobs.ps1, Removes all jobs from all printers
-remove-tag.ps1, Removes a tag in a Git repository 
-replace-in-files.ps1, Search and replace a pattern in the given files by the replacement
-restart-network-adapters.ps1, Restarts all local network adapters
-save-screenshot.ps1, Saves a single screenshot
-say-date.ps1, Say the current date by text-to-speech
-say-joke.ps1, Say a random Chuck Norris joke by text-to-speech
-say-quote.ps1, Say a random quote by text-to-speech
-say-time.ps1, Say the current time by text-to-speech
-search-filename.ps1, Searches the directory tree for filenames by given pattern 
-search-files.ps1, Searches the given pattern in the given files
-scan-ports.ps1, Scans the network for open/closed ports
-send-email.ps1, Sends an email message
-send-tcp.ps1, Sends a TCP message to the given IP address and port
-send-udp.ps1, Sends a UDP datagram message to the given IP address and port
-set-profile.ps1, Updates your PowerShell user profile
-set-timer.ps1, Sets a timer for a countdown
-set-wallpaper.ps1, Sets the given image as wallpaper
-simulate-matrix.ps1, Simulates the Matrix (fun)
-simulate-presence.ps1, Simulates the human presence against burglars
-speak-checklist.ps1, Speaks the given checklist by text-to-speech
-speak-countdown.ps1, Starts a countdown by text-to-speech
-speak-english.ps1, Speaks the given text with an English text-to-speech voice
-speak-epub.ps1, Speaks the content of the given Epub file by text-to-speech
-speak-file.ps1, Speaks the content of the given text file by text-to-speech
-speak-french.ps1, Speaks the given text with a French text-to-speech voice
-speak-german.ps1, Speaks the given text with a German text-to-speech voice
-speak-italian.ps1, Speaks the given text with an Italian text-to-speech voice
-speak-spanish.ps1, Speaks the given text with a Spanish text-to-speech voice
-speak-test.ps1, Performs a speak test by text-to-speech 
-speak-text.ps1, Speaks the given text by text-to-speech
-start-calibre-server.ps1, Starts a local Calibre server 
-start-ipfs-server.ps1, Starts a local IPFS server
-switch-branch.ps1, Switches the branch in the current/given Git repository (including submodules)
-switch-shelly1.ps1, Switches a Shelly1 device in the local network
-sync-repo.ps1, Synchronizes a Git repository by push & pull (including submodules)
-translate-file.ps1, Translates the given text file into another language
-translate-files.ps1, Translates the given text files into any supported language
-translate-text.ps1, Translates the given text into other languages
-turn-volume-up.ps1, Turns the audio volume up (+10% by default)
-turn-volume-down.ps1, Turns the audio volume down (-10% by default)
-unmute-audio.ps1, Unmutes audio
-upgrade-ubuntu.ps1, Upgrades Ubuntu Linux to the latest (LTS) release 
-upload-file.ps1, Uploads the local file to the given FTP server
-wakeup.ps1, Sends a magic packet to the given computer, waking him up
-weather.ps1, Prints the current weather forecast
-weather-report.ps1, Prints the local weather report
-what-is.ps1, Prints a description of the given abbreviation
-write-animated.ps1, Writes animated text
-write-big.ps1, Writes the given text in big letters
-write-blue.ps1, Writes the given text in a blue foreground color
-write-braille.ps1, Writes the given text in Braille
-write-calendar.ps1, Writes the calendar (month or year)
-write-green.ps1, Writes the given text in a green foreground color
-write-joke.ps1], Writes a random Juck Norris joke
-write-lowercase.ps1, Writes the given text in lowercase letters
-write-marquee.ps1, Writes the given text as marquee
-write-morse-code.ps1, Writes the given text in Morse code
-write-motd.ps1, Writes the message of the day (MOTD)
-write-quote.ps1, Writes a random quote
-write-red.ps1, Writes the given text in a red foreground color
-write-rot13.ps1, Encodes or decodes the given text with ROT13
-write-typewriter.ps1, Writes the given text with the typewriter effect
-write-uppercase.ps1, Writes the given text in uppercase letters
-write-vertical.ps1, Writes the given text in vertical direction

Data/template.ps1

@@ -1,33 +0,0 @@
-<#
-.SYNOPSIS
-	← enter overview of script here
-.DESCRIPTION
-	← enter brief description of script here
-.INPUTS
-	← enter inputs here (if any, otherwise state None)
-.OUTPUTS
-	← enter outputs here (if any, otherwise state None)
-.EXAMPLE
-	PS> .\template.ps1 ← enter example here (repeat this attribute for more than one example)
-.NOTES
-	Author:        ← enter full name here
-	License:       ← enter license here
-.LINK
-	← enter URL here
-#>
-
-#requires -version 4
-
-param() # ← enter script parameters here
-
-#	← enter functions here 
-
-try {
-#	← enter instructions here 
-
-	"✔️ Done."
-	exit 0
-} catch {
-	write-error "⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}

Data/web-dashboards.csv

@@ -1,20 +0,0 @@
-NAME,		URL
-Toggl Track,	"https://track.toggl.com/timer"
-Google Calendar,"https://calendar.google.com/calendar/u/0/r/agenda"
-Google Mail,	"https://mail.google.com/"
-Google Keep,	"https://keep.google.com/"
-Google Photos,	"https://photos.google.com/"
-Google News,	"https://news.google.com"
-Outlook Mail,	"https://outlook.office.com/mail/"
-CNN News,	"https://edition.cnn.com"
-GitHub Explore,	"https://github.com/explore"
-FlightRadar24,	"https://www.flightradar24.com/27.63,-6.98/3"
-Earthquake Watch,"https://www.arcgis.com/apps/dashboards/c8af9c5411814584b460cc87cb7c3780"
-Live Cyber Threat Map,"https://threatmap.checkpoint.com"
-Netflix Top 10,	"https://www.netflix.com/tudum/top10/"
-YouTube Music Charts,"https://charts.youtube.com/"
-Webcams,	"https://www.foto-webcam.eu"
-Peak Zugspitze,	"https://zugspitze.panomax.com"
-Airport Salzburg,"https://livecam.salzburg-airport.com"
-Windy Weather Radar,"https://www.windy.com/de/-Weather-radar-radar"
-Windy Weather Temperatures,"https://www.windy.com/-Temperature-temp"

Docs/FAQ.md

@@ -1,143 +0,0 @@
-PowerShell FAQ
-==============
-
-<details><summary>What is PowerShell?</summary>
- 
-**PowerShell is a task automation and configuration management framework from Microsoft, consisting of a command-line shell and associated scripting language.**
- 
-</details>
-
-<details><summary>Why use PowerShell?</summary>
- 
-✔️ **It's powerful** - fully control your computer
-
-✔️ **It's easy to learn** - see the tutorial at: https://www.guru99.com/powershell-tutorial.html
-
-✔️ **It's cross-platform** - available for Linux, Mac OS and Windows
-
-✔️ **It's open-source and free** - see the Github repository at: https://github.com/PowerShell/PowerShell
-
-✔️ **It's fully documented** - see the PowerShell documentation at: https://docs.microsoft.com/en-us/powershell/
-</details>
-
-<details><summary>How to install PowerShell?</summary>
-
-▶️ **On Windows** it's preinstalled, **but** the script execution policy is *restricted* (forbidden) by default! To change this: open the *Windows PowerShell (Administrator)* console and enter:
-```
- PS> Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope CurrentUser
-```
-NOTE: the group policy object (GPO) settings of your organization might disallow changes. In that case contact your system administrator for help.
-   
-▶️ **On CentOS, Debian, Docker, Fedora, macOS, openSUSE, Red Hat, Ubuntu** visit https://github.com/PowerShell/PowerShell for installation.
-
-▶️ **On Linux supporting Snaps** execute:
-```
- $ snap install PowerShell
- $ ln -s /snap/bin/pwsh /usr/bin/pwsh
-```
-</details>
-
-<details><summary>How to get the PowerShell scripts?</summary>
- 
-* When using **Git**, execute in a terminal window: `> git clone https://github.com/fleschutz/PowerShell`
-* **Otherwise,** download and unzip it from: https://github.com/fleschutz/PowerShell/archive/master.zip
-</details>
-
-<details><summary>How to execute PowerShell scripts in Windows?</summary>
-
-1. In the Windows desktop: right-click the script and select: *Execute with PowerShell*
-2. In a command-line interface (CLI, e.g. *Windows Terminal*, either local or remote via SSH) by typing: `./<FILENAME_OF_SCRIPT>`.
-3. By connecting a context menu item with a script.
-4. By voice control, e.g. see repo [talk2windows](https://github.com/fleschutz/talk2windows) for more information.
-5. By using automation software, e.g. [Jenkins](https://www.jenkins.io).
-6. Automatically on login (see AutoStart folder)/logoff/daily/etc.
- </details>
- 
-<details><summary>How to execute PowerShell scripts in Windows context menus?</summary>
-   
-* to enable "right-click > New > Windows PowerShell Script" execute `Add_ps1_to_New_context_menu.reg` in subfolder [Data/](../Data)
- 
-* to disable this execute `Remove_ps1_from_New_context_menu.reg` in subfolder [Data/](../Data)
-</details>
-
- 
-<details><summary>How to execute PowerShell scripts in Jenkins?</summary>
- 
-**Install the 'PowerShell plugin' in Jenkins, it allows to invoke PowerShell as build scripts. It uses PowerShell.exe on Windows and pwsh on Linux.**
-</details>
-
- <details><summary>What about security?</summary>
-
-* Execute scripts only that you trust (and/or where you have checked the code before)!
-* Prefer SSH Remoting instead of PowerShell Remoting
-* More recommendations by NSA and cyber security centers in the U.S. (CISA), New Zealand (NZ NCSC), and the U.K. (NCSC-UK) can be found here: https://media.defense.gov/2022/Jun/22/2003021689/-1/-1/1/CSI_KEEPING_POWERSHELL_SECURITY_MEASURES_TO_USE_AND_EMBRACE_20220622.PDF
- </details>
-
-<details><summary>Why do some scripts show gibberish characters?</summary>
-  
-**Your current terminal application doesn't support Unicode characters used by those PowerShell scripts. Use a modern one such as *Windows Terminal*, please.**
-</details>
-
-<details><summary>How to configure PowerShell as my default shell on Linux?</summary>
-  
-**Make sure PowerShell is installed, then execute: `chsh -s /usr/bin/pwsh USERNAME`. In case you experience an "invalid shell" error, add "/usr/bin/pwsh" to /etc/shells.**
-</details>
-
-<details><summary>How to install a custom PowerShell profile?</summary>
-   
-**Execute: `./set-profile.ps1` in the *Scripts* subfolder, this will install **my-profile.ps1** as your PowerShell profile. It's a nice looking base profile, but can easily be changed to your needs.**
-</details>
-
- <details><summary>How to add the scripts to the search path?</summary>
-
-Want to use the PowerShell scripts everywhere on the command-line? Then you need to add the Scripts/ subfolder to the search path:
-
-* **On Linux using Bash:** edit .profile in your home directory and add the line: PATH="$PATH:/path/to/PowerShell/Scripts"
-* **On Windows:** open Settings > System > About > Advanced system settings > Environment Variables, edit the user's variable "Path", and add the full path to the Scripts/ directory.
-   </details>
-
-<details><summary>Which editor to use for PowerShell scripts?</summary>
-
-* **Visual Studio Code** - it supports syntax highlighting, on-the-fly problem checking and an integrated PowerShell Console (available for free on Linux, Mac OS and Windows, now recommended by Microsoft).
-* **PowerShell ISE** (Integrated Scripting Environment) - the former official PowerShell development environment included with Microsoft Windows.
-* **PowerShell Studio** - a powerful PowerShell IDE with module, help, and user interface development tools, high DPI support and regular updates.
-* **PowerShell Plus** - an all in one IDE.
-* **Atom package** - an add-on with PowerShell language support for Atom.
-* **SublimeText package** - an add-on with PowerShell language support for Sublime Text.
-* or your **favorite text editor** as an alternative.
-</details>
-
-<details><summary>How to write good PowerShell scripts?</summary>
- 
-**Good PowerShell scripts are both user-friendly and platform-independent. As a starting point I recommend the following:**
-
-* As filename use the `<verb>-<object>.ps1` scheme. Approved verbs can be found here: [https://learn.microsoft.com/en-us/powershell/scripting/developer/cmdlet/approved-verbs-for-windows-powershell-commands](https://learn.microsoft.com/en-us/powershell/scripting/developer/cmdlet/approved-verbs-for-windows-powershell-commands)
-* Use `UTF-8 BOM` encoding to support Unicode characters in the script.
-* Add a comment-based help at the beginning with: `.SYNOPSIS`, `.DESCRIPTION`, `.PARAMETER`, `.EXAMPLE`, `.LINK`, and `.NOTES`.
-* Check the requirements for the script, e.g. `#Requires -RunAsAdministrator`, or `#Requires -Version 3`
-* Prefer command-line options, else ask the user for help
-* Recommended is `Set-StrictMode -Version Latest` to enable additional error checking.
-* For readibility use UpperCamelCase for variables and functions, lowerCamelCase for everything else.
-* Set *execute* file permissions for Linux: `chmod a+rx <filename>`
-* On success exit with error code 0 (`exit 0`), otherwise print the error with keyword "ERROR:" (to support log parsers) and exit the error code (mostly 1)
- </details>
-
-<details><summary>Where's the Star History of this repo?</summary>
-    
-[![Star History Chart](https://api.star-history.com/svg?repos=fleschutz/PowerShell&type=Date)](https://star-history.com/#fleschutz/PowerShell&Date)
-</details>
-
-<details><summary>How to contribute or how to report a bug?</summary>
-
-**If you find something bad (like a bug, error, or any issue), please report it here by opening an Issue. Or even better: Fork the repository, add or fix the script and submit a pull request, so others can participate too.**
-</details>
-
-<details><summary>How to donate to this project?</summary>
-
-**Just follow this link: [https://www.paypal.com/paypalme/Fleschutz](https://www.paypal.com/paypalme/Fleschutz). Thank you very much!**
-</details>
-
-<details><summary>What if my question is not answered here?</summary>
- 
-**Just send your question by e-mail to: markus.fleschutz [at] gmail.com**
-</details>

Docs/add-firewall-rules.md

@@ -1,112 +0,0 @@
-*add-firewall-rules.ps1*
-================
-
-This PowerShell script adds firewall rules for the given executable. Administrator rights are required.
-
-Parameters
-----------
-```powershell
-PS> ./add-firewall-rules.ps1 [[-PathToExecutables] <String>] [<CommonParameters>]
-
--PathToExecutables <String>
-    Specifies the path to the executables
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./add-firewall-rules.ps1 C:\MyApp\bin
-Adding firewall rule for C:\MyApp\bin\app1.exe
-Adding firewall rule for C:\MyApp\bin\app2.exe
-...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Adds firewall rules for executables (needs admin rights)
-.DESCRIPTION
-	This PowerShell script adds firewall rules for the given executable. Administrator rights are required.
-.PARAMETER PathToExecutables
-	Specifies the path to the executables
-.EXAMPLE
-	PS> ./add-firewall-rules.ps1 C:\MyApp\bin
-	Adding firewall rule for C:\MyApp\bin\app1.exe
-	Adding firewall rule for C:\MyApp\bin\app2.exe
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-#Requires -RunAsAdministrator
-
-param([string]$PathToExecutables = "")
-
-$command = '
-$output = ''Firewall rules for path '' + $args[0]
-write-output $output
-for($i = 1; $i -lt $args.count; $i++){
-	$path = $args[0]
-	$path += ''\''
-	$path += $args[$i]
-
-	$null = $args[$i] -match ''[^\\]*\.exe$''
-	$name = $matches[0]
-    $output = ''Adding firewall rule for '' + $name
-	write-output $output
-	$null = New-NetFirewallRule -DisplayName $name -Direction Inbound -Program $path -Profile Domain, Private -Action Allow
-}
-write-host -foregroundColor green -noNewline ''Done - press any key to continue...'';
-[void]$Host.UI.RawUI.ReadKey(''NoEcho,IncludeKeyDown'');
-'
-
-
-try {
-	if ($PathToExecutables -eq "" ) {
-		$PathToExecutables = read-host "Enter path to executables"
-	}
-
-	$PathToExecutables = Convert-Path -Path $PathToExecutables
-
-	$Apps = Get-ChildItem "$PathToExecutables\*.exe" -Name
-
-	if($Apps.count -eq 0){
-		write-warning "No executables found. No Firewall rules have been created."
-		Write-Host -NoNewhLine 'Press any key to continue...';
-		[void]$Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown');
-		exit 1
-	}
-
-	$arg = "PathToExecutables $Apps"
-	Start-Process powershell -Verb runAs -ArgumentList "-command & {$command}  $arg"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of add-firewall-rules.ps1 as of 08/06/2023 21:36:04)*

Docs/build-repo.md

@@ -1,180 +0,0 @@
-*build-repo.ps1*
-================
-
-This PowerShell script builds a repository by supporting: cmake, configure, autogen, Imakefile, and Makefile.
-
-Parameters
-----------
-```powershell
-PS> ./build-repo.ps1 [[-RepoDir] <String>] [<CommonParameters>]
-
--RepoDir <String>
-    Specifies the path to the Git repository
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./build-repo.ps1 C:\MyRepo
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Builds a repository 
-.DESCRIPTION
-	This PowerShell script builds a repository by supporting: cmake, configure, autogen, Imakefile, and Makefile.
-.PARAMETER RepoDir
-	Specifies the path to the Git repository
-.EXAMPLE
-	PS> ./build-repo.ps1 C:\MyRepo
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$RepoDir = "$PWD")
-
-function BuildInDir { param($Path)
-	$DirName = (Get-Item "$Path").Name
-	if (Test-Path "$Path/CMakeLists.txt" -pathType leaf) {
-		"⏳ Building repo 📂$DirName using CMakeLists.txt into subfolder _My_Build ..."
-		if (-not(Test-Path "$Path/_My_Build/" -pathType container)) { 
-			& mkdir "$Path/_My_Build/"
-		}
-		Set-Location "$Path/_My_Build/"
-
-		& cmake ..
-		if ($lastExitCode -ne "0") { throw "Executing 'cmake ..' has failed" }
-
-		& make -j4
-		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
-
-		& make test
-		if ($lastExitCode -ne "0") { throw "Executing 'make test' has failed" }
-
-	} elseif (Test-Path "$Path/configure" -pathType leaf) { 
-		"⏳ Building repo 📂$DirName using 'configure'..."
-		Set-Location "$Path/"
-
-		& ./configure
-		#if ($lastExitCode -ne "0") { throw "Script 'configure' exited with error code $lastExitCode" }
-
-		& make -j4
-		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
-
-		& make test
-		if ($lastExitCode -ne "0") { throw "Executing 'make test' has failed" }
-
-	} elseif (Test-Path "$Path/autogen.sh" -pathType leaf) { 
-		"⏳ Building repo 📂$DirName using 'autogen.sh'..."
-		Set-Location "$Path/"
-
-		& ./autogen.sh
-		if ($lastExitCode -ne "0") { throw "Script 'autogen.sh' exited with error code $lastExitCode" }
-
-		& make -j4
-		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
-
-	} elseif (Test-Path "$Path/build.gradle" -pathType leaf) {
-		"⏳ Building repo 📂$DirName using build.gradle..."
-		Set-Location "$Path"
-
-		& gradle build
-		if ($lastExitCode -ne "0") { throw "'gradle build' has failed" }
-
-		& gradle test
-		if ($lastExitCode -ne "0") { throw "'gradle test' has failed" }
-
-	} elseif (Test-Path "$Path/Imakefile" -pathType leaf) {
-		"⏳ Building repo 📂$DirName using Imakefile..."
-		Set-Location "$RepoDir/"
-
-		& xmkmf 
-		if ($lastExitCode -ne "0") { throw "Executing 'xmkmf' has failed" }
-
-		& make -j4
-		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
-
-	} elseif (Test-Path "$Path/Makefile" -pathType leaf) {
-		"⏳ Building repo 📂$DirName using Makefile..."
-		Set-Location "$Path"
-
-		& make -j4
-		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
-
-	} elseif (Test-Path "$Path/makefile" -pathType leaf) {
-		"⏳ Building repo 📂$DirName using makefile..."
-		Set-Location "$Path"
-
-		& make -j4
-		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
-
-	} elseif (Test-Path "$Path/compile.sh" -pathType leaf) { 
-		"⏳ Building repo 📂$DirName using 'compile.sh'..."
-		Set-Location "$Path/"
-
-		& ./compile.sh
-		if ($lastExitCode -ne "0") { throw "Script 'compile.sh' exited with error code $lastExitCode" }
-
-		& make -j4
-		if ($lastExitCode -ne "0") { throw "Executing 'make -j4' has failed" }
-
-	} elseif (Test-Path "$Path/attower/src/build/DevBuild/build.bat" -pathType leaf) {
-		"⏳ Building repo 📂$DirName using build.bat ..."
-		Set-Location "$Path/attower/src/build/DevBuild/"
-
-		& ./build.bat build-all-release
-		if ($lastExitCode -ne "0") { throw "Script 'build.bat' exited with error code $lastExitCode" }
-
-	} elseif (Test-Path "$Path/$DirName" -pathType container) {
-		"⏳ No make rule found, trying subfolder 📂$($DirName)..."
-		BuildInDir "$Path/$DirName"
-	} else {
-		Write-Warning "Sorry, no make rule applies to: 📂$DirName"
-		exit 0 # success
-	}
-}
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	if (-not(Test-Path "$RepoDir" -pathType container)) { throw "Can't access directory: $RepoDir" }
-	$RepoDirName = (Get-Item "$RepoDir").Name
-
-	$PreviousPath = Get-Location
-	BuildInDir "$RepoDir"
-	Set-Location "$PreviousPath"
-
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ built repo 📂$RepoDirName in $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of build-repo.ps1 as of 08/06/2023 21:36:05)*

Docs/cd-repos.md

@@ -1,83 +0,0 @@
-*cd-repos.ps1*
-================
-
-This PowerShell script changes the working directory to the user's Git repositories folder.
-
-Parameters
-----------
-```powershell
-PS> ./cd-repos.ps1 [[-Subpath] <String>] [<CommonParameters>]
-
--Subpath <String>
-    Specifies an additional relative subpath (optional)
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./cd-repos
-📂C:\Users\Markus\source\Repos
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Sets the working directory to the user's repos folder
-.DESCRIPTION
-	This PowerShell script changes the working directory to the user's Git repositories folder.
-.PARAMETER Subpath
-	Specifies an additional relative subpath (optional)
-.EXAMPLE
-	PS> ./cd-repos
-	📂C:\Users\Markus\source\Repos
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$Subpath = "")
-
-try {
-	if (Test-Path "$HOME/Repos" -pathType Container) {		# try short name
-		$Path = "$HOME/Repos/$Subpath"
-	} elseif (Test-Path "$HOME/Repositories" -pathType Container) {	# try long name
-		$Path = "$HOME/Repositories/$Subpath"
-	} elseif (Test-Path "$HOME/source/repos" -pathType Container) { # try Visual Studio default
-		$Path = "$HOME/source/repos/$Subpath"
-	} else {
-		throw "The folder for Git repositories in your home directory doesn't exist (yet)."
-	}
-	if (-not(Test-Path "$Path" -pathType Container)) { throw "The path to 📂$Path doesn't exist (yet)." }
-	$Path = Resolve-Path "$Path"
-	Set-Location "$Path"
-	"📂$Path"
-	exit 0 # success
-} catch {
-	"⚠️ Error: $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of cd-repos.ps1 as of 08/06/2023 21:36:05)*

Docs/check-apps.md

@@ -1,75 +0,0 @@
-*check-apps.ps1*
-================
-
-This PowerShell script queries the application status and prints it.
-
-Parameters
-----------
-```powershell
-PS> ./check-apps.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-apps.ps1
-✅ 119 apps installed, 11 upgrades available
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Query the app status
-.DESCRIPTION
-	This PowerShell script queries the application status and prints it.
-.EXAMPLE
-	PS> ./check-apps.ps1
-	✅ 119 apps installed, 11 upgrades available
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	if ($IsLinux) {
-		$NumSnaps = (snap list).Count - 1
-		Write-Host "✅ $($NumSnaps) snaps installed"
-	} else {
-		Write-Progress "⏳ Querying installed apps and updates..."
-		$Apps = Get-AppxPackage
-		$Status = "✅ $($Apps.Count) apps installed"
-
-		[int]$NumNonOk = 0
-		foreach($App in $Apps) { if ($App.Status -ne "Ok") { $NumNonOk++ } }
-		if ($NumNonOk -gt 0) { $Status += ", $NumNonOk non-ok" }
-		[int]$NumErrors = (Get-AppxLastError)
-		if ($NumErrors -gt 0) { $Status += ", $NumErrors errors" }
-
-		$NumUpdates = (winget upgrade --include-unknown).Count - 5
-		Write-Progress -Completed "."
-		Write-Host "$Status, $NumUpdates upgrades available"
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-apps.ps1 as of 08/06/2023 21:36:05)*

Docs/check-bios.md

@@ -1,79 +0,0 @@
-*check-bios.ps1*
-================
-
-This PowerShell script queries the BIOS status and prints it.
-
-Parameters
-----------
-```powershell
-PS> ./check-bios.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-bios.ps1
-✅ BIOS model F6 version ALASKA - 1072009 by American Megatrends Inc.
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Checks the BIOS status
-.DESCRIPTION
-	This PowerShell script queries the BIOS status and prints it.
-.EXAMPLE
-	PS> ./check-bios.ps1
-	✅ BIOS model F6 version ALASKA - 1072009 by American Megatrends Inc.
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	if ($IsLinux) {
-		Write-Progress "⏳ Querying BIOS details..."
-		$Model = (sudo dmidecode -s system-product-name)
-		if ("$Model" -ne "") {
-			$Version = (sudo dmidecode -s bios-version)
-			$RelDate = (sudo dmidecode -s bios-release-date)
-			$Manufacturer = (sudo dmidecode -s system-manufacturer)
-			Write-Host "✅ BIOS model $Model version $Version of $RelDate by $Manufacturer"
-		}
-		Write-Progress -completed "."
-	} else {
-		$BIOS = Get-CimInstance -ClassName Win32_BIOS
-		$Model = $BIOS.Name.Trim()
-		$Version = $BIOS.Version.Trim()
-		$Serial = $BIOS.SerialNumber.Trim()
-		$Manufacturer = $BIOS.Manufacturer.Trim()
-		if ($Serial -eq "To be filled by O.E.M.") {
-			Write-Host "✅ BIOS model $Model version $Version by $Manufacturer"
-		} else {
-			Write-Host "✅ BIOS model $Model version $Version, S/N $Serial, by $Manufacturer"
-		}
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-bios.ps1 as of 08/06/2023 21:36:05)*

Docs/check-cpu.md

@@ -1,106 +0,0 @@
-*check-cpu.ps1*
-================
-
-check-cpu.ps1 
-
-
-Parameters
-----------
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Checks the CPU status
-.DESCRIPTION
-	This PowerShell script queries the CPU status and prints it (name, type, speed, temperature, etc).
-.EXAMPLE
-	PS> ./check-cpu.ps1
-	✅ AMD Ryzen 5 5500U with Radeon Graphics (CPU0, 2100MHz, 31.3°C)
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-function GetCPUTemperatureInCelsius {
-	$Temp = 99999.9 # unsupported
-	if ($IsLinux) {
-		if (Test-Path "/sys/class/thermal/thermal_zone0/temp" -pathType leaf) {
-			[int]$IntTemp = Get-Content "/sys/class/thermal/thermal_zone0/temp"
-			$Temp = [math]::round($IntTemp / 1000.0, 1)
-		}
-	} else {
-		$Objects = Get-WmiObject -Query "SELECT * FROM Win32_PerfFormattedData_Counters_ThermalZoneInformation" -Namespace "root/CIMV2"
-		foreach ($Obj in $Objects) {
-			$HiPrec = $Obj.HighPrecisionTemperature
-			$Temp = [math]::round($HiPrec / 100.0, 1)
-		}
-	}
-	return $Temp;
-}
-
-function GetProcessorArchitecture {
-	if ("$env:PROCESSOR_ARCHITECTURE" -ne "") { return "$env:PROCESSOR_ARCHITECTURE" }
-	if ($IsLinux) {
-		$Name = $PSVersionTable.OS
-		if ($Name -like "*-generic *") {
-			if ([System.Environment]::Is64BitOperatingSystem) { return "x64" } else { return "x86" }
-		} elseif ($Name -like "*-raspi *") {
-			if ([System.Environment]::Is64BitOperatingSystem) { return "ARM64" } else { return "ARM32" }
-		} else {
-			return ""
-		}
-	}
-}
-
-try {
-	Write-Progress "⏳ Querying CPU details..."
-	$Status = "✅"
-	$Celsius = GetCPUTemperatureInCelsius
-	if ($Celsius -eq 99999.9) {
-		$Temp = "no temp"
-	} elseif ($Celsius -gt 50) {
-		$Temp = "$($Celsius)°C"
-		$Status = "⚠️"
-	} elseif ($Celsius -lt 0) {
-		$Temp = "$($Celsius)°C"
-		$Status = "⚠️"
-	} else {
-		$Temp = "$($Celsius)°C"
-	} 
-
-	$Arch = GetProcessorArchitecture
-	if ($IsLinux) {
-		$CPUName = "$Arch CPU"
-		$Arch = ""
-		$DeviceID = ""
-		$Speed = ""
-		$Socket = ""
-	} else {
-		$Details = Get-WmiObject -Class Win32_Processor
-		$CPUName = $Details.Name.trim()
-		$Arch = "$Arch, "
-		$DeviceID = "$($Details.DeviceID), "
-		$Speed = "$($Details.MaxClockSpeed)MHz, "
-		$Socket = "$($Details.SocketDesignation) socket, "
-	}
-	$Cores = [System.Environment]::ProcessorCount
-	Write-Progress -completed "done."
-	Write-Host "$Status $CPUName ($($Arch)$Cores cores, $($DeviceID)$($Speed)$($Socket)$Temp)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-cpu.ps1 as of 08/06/2023 21:36:05)*

Docs/check-dns-resolution.md

@@ -1,27 +0,0 @@
-## check-dns-resolution.ps1 - Checks the DNS resolution with frequently used domain names
-
-This script checks the DNS resolution with frequently used domain names.
-
-## Parameters
-```powershell
-/home/markus/Repos/PowerShell/Scripts/check-dns-resolution.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./check-dns-resolution
-✔️ 11.8 domains/sec (177 domains resolved in 15 sec)
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of check-dns-resolution.ps1*

Docs/check-dns-server.md

@@ -1,72 +0,0 @@
-## The *check-dns-server.ps1* Script
-
-check-dns-server.ps1 
-
-
-## Parameters
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Source Code
-```powershell
-<#
-.SYNOPSIS
-	Checks DNS server
-.DESCRIPTION
-	This PowerShell script checks the speed of public DNS server.
-.EXAMPLE
-	PS> ./check-dns-server
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-function CheckDNS { param($Name, $PriIPv4, $SecIPv4)
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-	$null = (nslookup whitehouse.gov $PriIPv4)
-	[int]$PriIPv4Elapsed = $StopWatch.Elapsed.TotalMilliseconds
-
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-	$null = (nslookup whitehouse.gov $SecIPv4)
-	[int]$SecIPv4Elapsed = $StopWatch.Elapsed.TotalMilliseconds
-
-	"   `"$Name`"; `"$PriIPv4`"; `"$PriIPv4Elapsed ms`"; `"$SecIPv4`"; `"$SecIPv4Elapsed ms`"; "
-}
- 
-try {
-	"Checking speed of public DNS server..."
-	"  `"Company`"; `"IPv4 primary`"; `"Latency in ms`"; `"IPv4 secondary`"; `"Latency in ms`"; "
-	CheckDNS "Cloudflare" 1.1.1.1 1.0.0.1
-	CheckDNS "Cloudflare with malware blocklist" 1.1.1.2 1.0.0.2
-	CheckDNS "Cloudflare with malware+adult blocklist" 1.1.1.3 1.0.0.3
-	CheckDNS "DNS.Watch" 84.200.69.80 84.200.70.40 
-	CheckDNS "FreeDNS Vienna" 37.235.1.174 37.235.1.177
-	CheckDNS "Google Public DNS" 8.8.8.8 8.8.4.4
-	CheckDNS "Level3 one" 4.2.2.1 4.2.2.1
-	CheckDNS "Level3 two" 4.2.2.2 4.2.2.2 
-	CheckDNS "Level3 three" 4.2.2.3 4.2.2.3
-	CheckDNS "Level3 four" 4.2.2.4 4.2.2.4
-	CheckDNS "Level3 five" 4.2.2.5 4.2.2.5
-	CheckDNS "Level3 six" 4.2.2.6 4.2.2.6
-	CheckDNS "OpenDNS Basic" 208.67.222.222 208.67.220.220 
-	CheckDNS "OpenDNS Family Shield" 208.67.222.123 208.67.220.123 
-	CheckDNS "OpenNIC" 94.247.43.254 94.247.43.254
-	CheckDNS "Quad9 with malware blocklist, with DNSSEC" 9.9.9.9 9.9.9.9
-	CheckDNS "Quad9, no malware blocklist, no DNSSEC" 9.9.9.10 9.9.9.10
-	CheckDNS "Quad9, with malware blocklist, with DNSSEC, with EDNS" 9.9.9.11 9.9.9.11
-	CheckDNS "Quad9, with malware blocklist, with DNSSEC, NXDOMAIN only" 9.9.9.12 9.9.9.12 
-	CheckDNS "Verisign Public DNS" 64.6.64.6 64.6.65.6
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*Generated by convert-ps2md.ps1 using the comment-based help of check-dns-server.ps1*

Docs/check-dns.md

@@ -1,75 +0,0 @@
-*check-dns.ps1*
-================
-
-This PowerShell script measures and prints the DNS resolution speed by using 200 popular domains.
-
-Parameters
-----------
-```powershell
-PS> ./check-dns.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-dns.ps1
-✅ DNS resolves 156.5 domains per second
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Check DNS resolution 
-.DESCRIPTION
-	This PowerShell script measures and prints the DNS resolution speed by using 200 popular domains.
-.EXAMPLE
-	PS> ./check-dns.ps1
-	✅ DNS resolves 156.5 domains per second
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
- 
-try {
-	Write-Progress "⏳ Resolving 200 popular domain names..."
-	$table = Import-CSV "$PSScriptRoot/../Data/popular-domains.csv"
-	$numRows = $table.Length
-
-	$stopWatch = [system.diagnostics.stopwatch]::startNew()
-	if ($IsLinux) {
-foreach($row in $table){$nop=dig $row.Domain +short}
-	} else {
-foreach($row in $table){$nop=Resolve-DNSName $row.Domain}
-	}
-	Write-Progress -completed "."
-	[float]$elapsed = $stopWatch.Elapsed.TotalSeconds
-	$average = [math]::round($numRows / $elapsed, 1)
-	if ($average -lt 10.0) {
-		Write-Output "⚠️ DNS resolves $average domains per second only"
-	} else {  
-		Write-Output "✅ DNS resolves $average domains per second"
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-dns.ps1 as of 08/06/2023 21:36:05)*

Docs/check-drive-space.md

@@ -1,94 +0,0 @@
-*check-drive-space.ps1*
-================
-
-This PowerShell script checks a drive for free space left (20 GB by default).
-
-Parameters
-----------
-```powershell
-PS> ./check-drive-space.ps1 [[-Drive] <String>] [[-MinLevel] <Int32>] [<CommonParameters>]
-
--Drive <String>
-    Specifies the drive to check
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--MinLevel <Int32>
-    Specifies the minimum level in Gigabyte
-    
-    Required?                    false
-    Position?                    2
-    Default value                20
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-drive-space C
-✔️ 172 GB left on drive C (61 of 233 GB used)
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Checks a drive for free space left 
-.DESCRIPTION
-	This PowerShell script checks a drive for free space left (20 GB by default).
-.PARAMETER Drive
-	Specifies the drive to check
-.PARAMETER MinLevel
-	Specifies the minimum level in Gigabyte
-.EXAMPLE
-	PS> ./check-drive-space C
-	✔️ 172 GB left on drive C (61 of 233 GB used)
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$Drive = "", [int]$MinLevel = 20) # minimum level in GB
-
-try {
-	if ($Drive -eq "" ) { $Drive = read-host "Enter drive to check" }
-
-	$DriveDetails = (get-psdrive $Drive)
-	[int]$Free = (($DriveDetails.Free / 1024) / 1024) / 1024
-	[int]$Used = (($DriveDetails.Used / 1024) / 1024) / 1024
-	[int]$Total = ($Used + $Free)
-
-	if ($Free -lt $MinLevel) {
-        	write-warning "Drive $Drive has only $Free GB left to use! ($Used of $Total GB used, minimum is $MinLevel GB)"
-		exit 1
-	}
-
-	& "$PSScriptRoot/speak-english.ps1" "Drive $Drive has $Free GB left ($Total GB total)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-drive-space.ps1 as of 08/06/2023 21:36:05)*

Docs/check-drives.md

@@ -1,111 +0,0 @@
-*check-drives.ps1*
-================
-
-This PowerShell script checks all drives for free space left.
-
-Parameters
-----------
-```powershell
-PS> ./check-drives.ps1 [[-MinLevel] <Int32>] [<CommonParameters>]
-
--MinLevel <Int32>
-    Specifies the minimum warning level (10 GB by default)
-    
-    Required?                    false
-    Position?                    1
-    Default value                10
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-drives.ps1
-✅ Drive C: with 250GB at 10%, 225GB free
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Checks the drive space
-.DESCRIPTION
-	This PowerShell script checks all drives for free space left.
-.PARAMETER MinLevel
-	Specifies the minimum warning level (10 GB by default)
-.EXAMPLE
-	PS> ./check-drives.ps1
-	✅ Drive C: with 250GB at 10%, 225GB free
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([int]$MinLevel = 10) # 10 GB minimum
-
-function Bytes2String { param([int64]$Bytes)
-        if ($Bytes -lt 1000) { return "$Bytes bytes" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)KB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)MB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)GB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)TB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)PB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)EB" }
-}
-
-try {
-	Write-Progress "⏳ Querying drives..."
-	$Drives = Get-PSDrive -PSProvider FileSystem
-	Write-Progress -completed "."
-	foreach($Drive in $Drives) {
-		$Details = (Get-PSDrive $Drive.Name)
-		if ($IsLinux) { $ID = $Drive.Name } else { $ID = $Drive.Name + ":" }
-		[int64]$Free = $Details.Free
- 		[int64]$Used = $Details.Used
-		[int64]$Total = ($Used + $Free)
-
-		if ($Total -eq 0) {
-			Write-Host "✅ Drive $ID is empty"
-		} elseif ($Free -eq 0) {
-			Write-Host "⚠️ Drive $ID with $(Bytes2String $Total) is 100% full"
-		} elseif ($Free -lt $MinLevel) {
-			Write-Host "⚠️ Drive $ID with $(Bytes2String $Total) is nearly full, $(Bytes2String $Free) free"
-		} else {
-			[int]$Percent = ($Used * 100) / $Total
-			if ($Percent -gt 90) {
-				Write-Host "✅ Drive $ID with $(Bytes2String $Total) is $Percent% full, $(Bytes2String $Free) free"
-			} else {
-				Write-Host "✅ Drive $ID with $(Bytes2String $Total) at $Percent%, $(Bytes2String $Free) free"
-			}
-		}
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-drives.ps1 as of 08/06/2023 21:36:05)*

Docs/check-ping.md

@@ -1,91 +0,0 @@
-*check-ping.ps1*
-================
-
-This PowerShell script measures the ping roundtrip times from the local computer to 10 Internet servers.
-
-Parameters
-----------
-```powershell
-PS> ./check-ping.ps1 [[-hosts] <String>] [<CommonParameters>]
-
--hosts <String>
-    Specifies the hosts to check, seperated by commata (default is: amazon.com,bing.com,cnn.com,dropbox.com,facebook.com,github.com,google.com,live.com,twitter.com,youtube.com)
-    
-    Required?                    false
-    Position?                    1
-    Default value                amazon.com,bing.com,cnn.com,dropbox.com,facebook.com,github.com,google.com,live.com,twitter.com,youtube.com
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-ping.ps1
-✅ Ping latency is 29ms average (13ms...109ms, 0 loss)
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Checks the ping latency 
-.DESCRIPTION
-	This PowerShell script measures the ping roundtrip times from the local computer to 10 Internet servers.
-.PARAMETER hosts
-	Specifies the hosts to check, seperated by commata (default is: amazon.com,bing.com,cnn.com,dropbox.com,facebook.com,github.com,google.com,live.com,twitter.com,youtube.com)
-.EXAMPLE
-	PS> ./check-ping.ps1
-	✅ Ping latency is 29ms average (13ms...109ms, 0 loss)
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$hosts = "amazon.com,bing.com,cnn.com,dropbox.com,facebook.com,github.com,google.com,live.com,twitter.com,youtube.com")
-
-try {
-	Write-Host "✅ Ping latency is" -noNewline
-	$hostsArray = $hosts.Split(",")
-	$t = $hostsArray | foreach {
-		(New-Object Net.NetworkInformation.Ping).SendPingAsync($_, 250)
-	}
-	[Threading.Tasks.Task]::WaitAll($t)
-	[int]$min = 9999999
-	[int]$max = [int]$avg = [int]$successCount = [int]$lossCount = 0
-	foreach($ping in $t.Result) {
-		if ($ping.Status -eq "Success") {
-			[int]$latency = $ping.RoundtripTime
-			if ($latency -lt $min) { $min = $Latency }
-			if ($latency -gt $max) { $max = $Latency }
-			$avg += $latency
-			$successCount++
-		} else {
-			$lossCount++
-		}
-	}
-	$avg /= $successCount
-	Write-Host " $($avg)ms average ($($min)ms...$($max)ms, $lossCount loss)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-ping.ps1 as of 08/06/2023 21:36:06)*

Docs/check-powershell.md

@@ -1,67 +0,0 @@
-*check-powershell.ps1*
-================
-
-This PowerShell script queries the PowerShell status and prints it.
-
-Parameters
-----------
-```powershell
-PS> ./check-powershell.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-powershell.ps1
-✅ PowerShell Desktop edition 5.1.19041.2673 (10 modules, 1458 cmdlets, 172 aliases)
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Check the PowerShell status
-.DESCRIPTION
-	This PowerShell script queries the PowerShell status and prints it.
-.EXAMPLE
-	PS> ./check-powershell.ps1
-	✅ PowerShell Desktop edition 5.1.19041.2673 (10 modules, 1458 cmdlets, 172 aliases)
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	$Version = $PSVersionTable.PSVersion
-	$Edition = $PSVersionTable.PSEdition
-	$NumModules = (Get-Module).Count
-	$NumAliases = (Get-Alias).Count
-	if ($IsLinux) {
-		"✅ PowerShell $Edition edition $Version ($NumModules modules, $NumAliases aliases)"
-	} else {
-		$NumCmdlets = (Get-Command -Command-Type cmdlet).Count
-		"✅ PowerShell $Edition edition $Version ($NumModules modules, $NumCmdlets cmdlets, $NumAliases aliases)"
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-powershell.ps1 as of 08/06/2023 21:36:06)*

Docs/check-smart-devices.md

@@ -1,98 +0,0 @@
-*check-smart-devices.ps1*
-================
-
-check-smart-devices.ps1 
-
-
-Parameters
-----------
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Checks the SMART device status
-.DESCRIPTION
-	This PowerShell script queries the status of the SSD/HDD devices (supporting S.M.A.R.T.) and prints it.
-.EXAMPLE
-	PS> ./check-smart-devices.ps1
-	✅ 1TB Samsung SSD 970 EVO via NVMe (2388 hours, 289x on, v2B2QEXE7, 37°C, selftest passed)
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-function Bytes2String { param([int64]$Bytes)
-	if ($Bytes -lt 1000) { return "$Bytes bytes" }
-	$Bytes /= 1000
-	if ($Bytes -lt 1000) { return "$($Bytes)KB" }
-	$Bytes /= 1000
-	if ($Bytes -lt 1000) { return "$($Bytes)MB" }
-	$Bytes /= 1000
-	if ($Bytes -lt 1000) { return "$($Bytes)GB" }
-	$Bytes /= 1000
-	if ($Bytes -lt 1000) { return "$($Bytes)TB" }
-	$Bytes /= 1000
-	if ($Bytes -lt 1000) { return "$($Bytes)PB" }
-	$Bytes /= 1000
-	if ($Bytes -lt 1000) { return "$($Bytes)EB" }
-}
-
-try {
-	Write-Progress "⏳ (1/3) Searching for smartmontools..."
-	$Result = (smartctl --version)
-	if ($lastExitCode -ne "0") { throw "Can't execute 'smartctl' - make sure smartmontools are installed" }
-
-	Write-Progress "⏳ (2/3) Scanning S.M.A.R.T devices..."
-	if ($IsLinux) {
-		$Devices = $(sudo smartctl --scan-open)
-	} else {
-		$Devices = $(smartctl --scan-open)
-	}
-
-	foreach($Device in $Devices) {
-		Write-Progress "⏳ (3/3) Querying S.M.A.R.T devices..."
-		$Array = $Device.split(" ")
-		$Device = $Array[0]
-		if ("$Device" -eq "#") {
-			continue
-		} elseif ($IsLinux) {
-			$Details = (sudo smartctl --all --json $Device) | ConvertFrom-Json
-			$null = (sudo smartctl --test=short $Device)
-		} else {
-			$Details = (smartctl --all --json $Device) | ConvertFrom-Json
-			$null = (smartctl --test=short $Device)
-		}
-		$ModelName = $Details.model_name
-		$Protocol = $Details.device.protocol
-		[int64]$GBytes = $Details.user_capacity.bytes
-		if ($GBytes -gt 0) {
-			$Capacity = "$(Bytes2String $GBytes) "
-		} else {
-			$Capacity = ""
-		}
-		$Temp = $Details.temperature.current
-		$Firmware = $Details.firmware_version
-		$PowerOn = $Details.power_cycle_count
-		$Hours = $Details.power_on_time.hours
-		if ($Details.smart_status.passed) { $Status = "passed" } else { $Status = "FAILED" }
-		Write-Progress -completed " "
-		Write-Host "✅ $($Capacity)$ModelName via $Protocol ($Hours hours, $($PowerOn)x on, v$($Firmware), $($Temp)°C, selftest $Status)"
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-smart-devices.ps1 as of 08/06/2023 21:36:06)*

Docs/check-swap-space.md

@@ -1,112 +0,0 @@
-*check-swap-space.ps1*
-================
-
-This PowerShell script queries the status of the swap space and prints it.
-
-Parameters
-----------
-```powershell
-PS> ./check-swap-space.ps1 [[-MinLevel] <Int32>] [<CommonParameters>]
-
--MinLevel <Int32>
-    Specifies the minimum level (10 GB by default)
-    
-    Required?                    false
-    Position?                    1
-    Default value                10
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-swap-space.ps1
-✅ Swap space with 1GB at 42%, 748MB free
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Checks the swap space status
-.DESCRIPTION
-	This PowerShell script queries the status of the swap space and prints it.
-.PARAMETER MinLevel
-	Specifies the minimum level (10 GB by default)
-.EXAMPLE
-	PS> ./check-swap-space.ps1
-	✅ Swap space with 1GB at 42%, 748MB free
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([int]$MinLevel = 10) # minimum level in GB
-
-function MB2String { param([int64]$Bytes)
-        if ($Bytes -lt 1000) { return "$($Bytes)MB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)GB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)TB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)PB" }
-        $Bytes /= 1000
-        if ($Bytes -lt 1000) { return "$($Bytes)EB" }
-}
-
-try {
-	[int]$Total = [int]$Used = [int]$Free = 0
-	if ($IsLinux) {
-		$Result = $(free --mega | grep Swap:)
-		[int]$Total = $Result.subString(5,14)
-		[int]$Used = $Result.substring(20,13)
-		[int]$Free = $Result.substring(32,11)
-	} else {
-		$Items = Get-WmiObject -class "Win32_PageFileUsage" -namespace "root\CIMV2" -computername localhost 
-		foreach ($Item in $Items) { 
-			$Total = $Item.AllocatedBaseSize
-			$Used = $Item.CurrentUsage
-			$Free = ($Total - $Used)
-		} 
-	}
-	if ($Total -eq 0) {
-        	Write-Output "⚠️ No swap space configured"
-	} elseif ($Free -eq 0) {
-		Write-Output "⚠️ Swap space with $(MB2String $Total) is full"
-	} elseif ($Free -lt $MinLevel) {
-		Write-Output "⚠️ Swap space with $(MB2String $Total) is nearly full, only $(MB2String $Free) free"
-	} elseif ($Used -eq 0) {
-		Write-Output "✅ Swap space with $(MB2String $Total) reserved"
-	} else {
-		[int]$Percent = ($Used * 100) / $Total
-		if ($Percent -ge 90) {
-			Write-Output "✅ Swap space with $(MB2String $Total) is $Percent% full, $(MB2String $Free) free"
-		} else {
-			Write-Output "✅ Swap space with $(MB2String $Total) at $Percent%, $(MB2String $Free) free"
-		}
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-swap-space.ps1 as of 08/06/2023 21:36:06)*

Docs/check-uptime.md

@@ -1,85 +0,0 @@
-*check-uptime.ps1*
-================
-
-This PowerShell script queries the computer's uptime and prints it.
-
-Parameters
-----------
-```powershell
-PS> ./check-uptime.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./check-uptime.ps1
-✅ Up for 2 days, 20 hours, 10 minutes
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Checks the uptime 
-.DESCRIPTION
-	This PowerShell script queries the computer's uptime and prints it.
-.EXAMPLE
-	PS> ./check-uptime.ps1
-	✅ Up for 2 days, 20 hours, 10 minutes
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	if ($IsLinux) {
-		$Uptime = (Get-Uptime)
-	} else {
-		$BootTime = Get-WinEvent -ProviderName eventlog | Where-Object {$_.Id -eq 6005} | Select-Object TimeCreated -First 1 
-		$Uptime = New-TimeSpan -Start $BootTime.TimeCreated.Date -End (Get-Date)
-	}
-	$Reply = "✅ Up for "
-	$Days = $Uptime.Days
-	if ($Days -eq "1") {
-		$Reply += "1 day, "
-	} elseif ($Days -ne "0") {
-		$Reply += "$Days days, "
-	}
-
-	$Hours = $Uptime.Hours
-	if ($Hours -eq "1") {
-		$Reply += "1 hour, "
-	} elseif ($Hours -ne "0") {
-		$Reply += "$Hours hours, "
-	}
-
-	$Minutes = $Uptime.Minutes 
-	if ($Minutes -eq "1") {
-		$Reply += "1 minute"
-	} else {
-		$Reply += "$Minutes minutes"
-	}
-	Write-Host $Reply
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of check-uptime.ps1 as of 08/06/2023 21:36:06)*

Docs/clone-repos.md

@@ -1,122 +0,0 @@
-*clone-repos.ps1*
-================
-
-This PowerShell script clones popular Git repositories into a target directory.
-
-Parameters
-----------
-```powershell
-PS> ./clone-repos.ps1 [[-TargetDir] <String>] [<CommonParameters>]
-
--TargetDir <String>
-    Specifies the file path to the target directory (current working directory by default)
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./clone-repos C:\Repos
-⏳ (1) Searching for Git executable...          git version 2.41.0.windows.3
-⏳ (2) Loading Data/popular-git-repos.csv...    28 repos
-⏳ (3) Checking target folder...                📂repos
-⏳ (4/32) Cloning into 📂base256unicode (dev tool)...
-...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Clones Git repos
-.DESCRIPTION
-	This PowerShell script clones popular Git repositories into a target directory.
-.PARAMETER targetDir
-	Specifies the file path to the target directory (current working directory by default)
-.EXAMPLE
-	PS> ./clone-repos C:\Repos
-	⏳ (1) Searching for Git executable...          git version 2.41.0.windows.3
-	⏳ (2) Loading Data/popular-git-repos.csv...    28 repos
-	⏳ (3) Checking target folder...                📂repos
-	⏳ (4/32) Cloning into 📂base256unicode (dev tool)...
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$TargetDir = "$PWD")
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	Write-Host "⏳ (1) Searching for Git executable...          " -noNewline
-	& git --version
-	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
-
-	Write-Host "⏳ (2) Loading Data/popular-git-repos.csv...    " -noNewline
-	$Table = Import-CSV "$PSScriptRoot/../Data/popular-git-repos.csv"
-	$NumEntries = $Table.count
-	Write-Host "$NumEntries repos"
-
-	$TargetDirName = (Get-Item "$TargetDir").Name
-	Write-Host "⏳ (3) Checking target folder...                📂$TargetDirName"
-	if (-not(Test-Path "$TargetDir" -pathType container)) { throw "Can't access directory: $TargetDir" }
-	
-	[int]$Step = 3
-	[int]$Cloned = 0
-	[int]$Skipped = 0
-	foreach($Row in $Table) {
-		[string]$FolderName = $Row.FOLDERNAME
-		[string]$Category = $Row.CATEGORY
-		[string]$Branch = $Row.BRANCH
-		[string]$Full = $Row.FULL
-		[string]$URL = $Row.URL
-		$Step++
-
-		if (Test-Path "$TargetDir/$FolderName" -pathType container) {
-			"⏳ ($Step/$($NumEntries + 4)) Skipping existing 📂$FolderName ($Category)..."
-			$Skipped++
-			continue
-		}
-		if ($Full -eq "yes") {
-			"⏳ ($Step/$($NumEntries + 4)) Cloning into 📂$FolderName ($Category) - $Branch branch with full history..."
-			& git clone --branch "$Branch" --recurse-submodules "$URL" "$TargetDir/$FolderName"
-			if ($lastExitCode -ne "0") { throw "'git clone --branch $Branch $URL' failed with exit code $lastExitCode" }
-		} else {
-			"⏳ ($Step/$($NumEntries + 4)) Cloning into 📂$FolderName ($Category) - $Branch branch only..."
-			& git clone --branch "$Branch" --single-branch --recurse-submodules "$URL" "$TargetDir/$FolderName"
-			if ($lastExitCode -ne "0") { throw "'git clone --branch $Branch $URL' failed with exit code $lastExitCode" }
-		}
-		$Cloned++
-	}
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ Cloning $Cloned of $NumEntries Git repos into folder 📂$TargetDirName took $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of clone-repos.ps1 as of 08/06/2023 21:36:06)*

Docs/copy-photos-sorted.md

@@ -1,109 +0,0 @@
-*copy-photos-sorted.ps1*
-================
-
-copy-photos-sorted.ps1 [[-SourceDir] <string>] [[-TargetDir] <string>]
-
-
-Parameters
-----------
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Copy photos sorted by year and month
-.DESCRIPTION
-	This PowerShell script copies image files from SourceDir to TargetDir sorted by year and month.
-.PARAMETER SourceDir
-	Specifies the path to the source folder
-.PARAMTER TargetDir
-	Specifies the path to the target folder
-.EXAMPLE
-	PS> ./copy-photos-sorted.ps1 D:\iPhone\DCIM C:\MyPhotos
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$SourceDir = "", [string]$TargetDir = "")
-
-function CopyFile { param([string]$SourcePath, [string]$TargetDir, [int]$Date, [string]$Filename)
-	[int]$Year = $Date / 10000
-	[int]$Month = ($Date / 100) % 100
-	$MonthDir = switch($Month) {
-	1  {"01 JAN"}
-	2  {"02 FEB"}
-	3  {"03 MAR"}
-	4  {"04 APR"}
-	5  {"05 MAY"}
-	6  {"06 JUN"}
-	7  {"07 JUL"}
-	8  {"08 AUG"}
-	9  {"09 SEP"}
-	10 {"10 OCT"}
-	11 {"11 NOV"}
-	12 {"12 DEC"}
-	}
-	$TargetPath = "$TargetDir/$Year/$MonthDir/$Filename"
-	if (Test-Path "$TargetPath" -pathType leaf) {
-		Write-Host "⏳ Skipping existing $Year/$MonthDir/$Filename..."
-	} else {
-		Write-Host "⏳ Copying $Filename to $Year/$MonthDir..."
-		New-Item -path "$TargetDir" -name "$Year" -itemType "directory" -force | out-null
-		New-Item -path "$TargetDir/$Year" -name "$MonthDir" -itemType "directory" -force | out-null
-		Copy-Item "$SourcePath" "$TargetPath" -force
-	}
-}
-
-try {
-	if ($SourceDir -eq "") { $SourceDir = Read-Host "Enter file path to source directory" }
-	if ($TargetDir -eq "") { $TargetDir = Read-Host "Enter file path to target directory" }
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	Write-Host "⏳ Checking source directory 📂$($SourceDir)..."
-	if (-not(Test-Path "$SourceDir" -pathType container)) { throw "Can't access source directory: $SourceDir" }
-	$Files = (Get-ChildItem "$SourceDir\*.jpg" -attributes !Directory)
-
-	Write-Host "⏳ Checking target directory 📂$($TargetDir)..."
-	if (-not(Test-Path "$TargetDir" -pathType container)) { throw "Can't access target directory: $TargetDir" }
-
-	foreach($File in $Files) {
-		$Filename = (Get-Item "$File").Name
-		if ("$Filename" -like "IMG_*_*.jpg") {
-			$Array = $Filename.split("_")
-			CopyFile "$File" "$TargetDir" $Array[1] "$Filename"
-		} elseif ("$Filename" -like "IMG-*-*.jpg") {
-			$Array = $Filename.split("-")
-			CopyFile "$File" "$TargetDir" $Array[1] "$Filename"
-		} elseif ("$Filename" -like "PANO_*_*.jpg") {
-			$Array = $Filename.split("_")
-			CopyFile "$File"  "$TargetDir" $Array[1] "$Filename"
-		} elseif ("$Filename" -like "PANO-*-*.jpg") {
-			$Array = $Filename.split("-")
-			CopyFile "$File" "$TargetDir" $Array[1] "$Filename"
-		} elseif ("$Filename" -like "SAVE_*_*.jpg") {
-			$Array = $Filename.split("_")
-			CopyFile "$File" "$TargetDir" $Array[1] "$Filename"
-		} else {
-			Write-Host "⏳ Skipping $Filename with unknown filename format..."
-		}
-	}
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ copied $($Files.Count) photos from 📂$SourceDir to 📂$TargetDir in $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of copy-photos-sorted.ps1 as of 08/06/2023 21:36:07)*

Docs/count-lines-of-code.md

@@ -1,88 +0,0 @@
-*count-lines-of-code.ps1*
-================
-
-This PowerShell script counts the number of code lines in a folder (including subfolders).
-
-Parameters
-----------
-```powershell
-PS> ./count-lines-of-code.ps1 [[-Folder] <String>] [<CommonParameters>]
-
--Folder <String>
-    Specifies the path to the folder
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./count-lines-of-code.ps1 .
-⏳ Counting lines at 📂C:\PowerShell\Scripts ...
-✔️ 📂Scripts contains 15287 lines of code in 485 files (took 1 sec)
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Counts lines of code
-.DESCRIPTION
-	This PowerShell script counts the number of code lines in a folder (including subfolders).
-.PARAMETER Folder
-	Specifies the path to the folder
-.EXAMPLE
-	PS> ./count-lines-of-code.ps1 .
-	⏳ Counting lines at 📂C:\PowerShell\Scripts ...
-	✔️ 📂Scripts contains 15287 lines of code in 485 files (took 1 sec)
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$Folder = "")
-
-try {
-	if ($Folder -eq "" ) { $Folder = read-host "Enter the path to the folder" }
-
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-	$Folder = Resolve-Path "$Folder"
-	"⏳ Counting lines at 📂$Folder ..."
-
-	[int]$Files = [int]$CodeLines = 0
-	Get-ChildItem -Path $Folder -Include *.c,*.h,*.cpp,*.hpp,*.java,*.ps1 -Recurse | ForEach-Object {
-		$FileStats = Get-Content $_.FullName | Measure-Object -line
-		$CodeLines += $FileStats.Lines
-		$Files++
-	}
-
-	$FolderName = (Get-Item "$Folder").Name
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ 📂$FolderName contains $CodeLines lines of code in $Files files (took $Elapsed sec)" 
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of count-lines-of-code.ps1 as of 08/06/2023 21:36:07)*

Docs/edit.md

@@ -1,75 +0,0 @@
-*edit.ps1*
-================
-
-This PowerShell script opens a text editor to edit the given file.
-
-Parameters
-----------
-```powershell
-PS> ./edit.ps1 [[-Filename] <String>] [<CommonParameters>]
-
--Filename <String>
-    Specifies the path to the filename
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./edit.ps1 C:\MyFile.txt
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Opens an editor to edit a file
-.DESCRIPTION
-	This PowerShell script opens a text editor to edit the given file.
-.PARAMETER Filename
-	Specifies the path to the filename
-.EXAMPLE
-	PS> ./edit.ps1 C:\MyFile.txt
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$Filename = "")
-
-try {
-	if ($IsLinux) {
-		& vi "$Filename"
-		if ($lastExitCode -ne "0") { throw "Can't execute 'vi' - make sure vi is installed and available" }
-	} else {
-		& notepad.exe "$Filename"
-		if ($lastExitCode -ne "0") { throw "Can't execute 'notepad.exe' - make sure notepad.exe is installed and available" }
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of edit.ps1 as of 08/06/2023 21:36:07)*

Docs/export-to-manuals.md

@@ -1,93 +0,0 @@
-*export-to-manuals.ps1*
-================
-
-This PowerShell script exports the comment based help of all PowerShell scripts as manuals.
-
-Parameters
-----------
-```powershell
-PS> ./export-to-manuals.ps1 [[-FilePattern] <String>] [[-TargetDir] <String>] [<CommonParameters>]
-
--FilePattern <String>
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PSScriptRoot/*.ps1"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--TargetDir <String>
-    
-    Required?                    false
-    Position?                    2
-    Default value                "$PSScriptRoot/../Docs"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./export-to-manuals.ps1
-⏳ (1/2) Reading PowerShell scripts from /home/mf/PowerShell/Scripts/*.ps1 ... 
-⏳ (2/2) Exporting Markdown manuals to /home/mf/PowerShell/Scripts/../Docs ...
-✔️ Exporting 518 Markdown manuals took 28 sec
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Exports all scripts as manuals
-.DESCRIPTION
-	This PowerShell script exports the comment based help of all PowerShell scripts as manuals.
-.EXAMPLE
-	PS> ./export-to-manuals.ps1
-	⏳ (1/2) Reading PowerShell scripts from /home/mf/PowerShell/Scripts/*.ps1 ... 
-	⏳ (2/2) Exporting Markdown manuals to /home/mf/PowerShell/Scripts/../Docs ...
-	✔️ Exporting 518 Markdown manuals took 28 sec
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-#requires -version 2
-
-param([string]$FilePattern = "$PSScriptRoot/*.ps1", [string]$TargetDir = "$PSScriptRoot/../Docs")
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	"⏳ (1/2) Reading PowerShell scripts from $FilePattern ..." 
-	$Scripts = Get-ChildItem "$FilePattern"
-
-	"⏳ (2/2) Exporting Markdown manuals to $TargetDir ..."
-	foreach ($Script in $Scripts) {
-		& "$PSScriptRoot/convert-ps2md.ps1" "$Script" > "$TargetDir/$($Script.BaseName).md"
-	}
-
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ Exporting $($Scripts.Count) Markdown manuals took $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of export-to-manuals.ps1 as of 08/06/2023 21:36:07)*

Docs/fetch-repos.md

@@ -1,100 +0,0 @@
-*fetch-repos.ps1*
-================
-
-This PowerShell script fetches updates into all Git repositories in a folder (including submodules).
-
-Parameters
-----------
-```powershell
-PS> ./fetch-repos.ps1 [[-ParentDir] <String>] [<CommonParameters>]
-
--ParentDir <String>
-    Specifies the path to the parent folder
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./fetch-repos.ps1 C:\MyRepos
-⏳ (1) Searching for Git executable...  git version 2.41.0.windows.3
-⏳ (2) Checking parent folder...        33 subfolders
-⏳ (3/35) Fetching into 📂base256unicode...
-...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Fetches updates into Git repos
-.DESCRIPTION
-	This PowerShell script fetches updates into all Git repositories in a folder (including submodules).
-.PARAMETER ParentDir
-	Specifies the path to the parent folder
-.EXAMPLE
-	PS> ./fetch-repos.ps1 C:\MyRepos
-	⏳ (1) Searching for Git executable...  git version 2.41.0.windows.3
-	⏳ (2) Checking parent folder...        33 subfolders
-	⏳ (3/35) Fetching into 📂base256unicode...
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$ParentDir = "$PWD")
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	Write-Host "⏳ (1) Searching for Git executable...  " -noNewline
-	& git --version
-	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
-
-	Write-Host "⏳ (2) Checking parent folder...        " -noNewline
-	if (-not(Test-Path "$ParentDir" -pathType container)) { throw "Can't access folder: $ParentDir" }
-	$Folders = (Get-ChildItem "$ParentDir" -attributes Directory)
-	$NumFolders = $Folders.Count
-	$ParentDirName = (Get-Item "$ParentDir").Name
-	Write-Host "$NumFolders subfolders"
-
-	[int]$Step = 2
-	foreach ($Folder in $Folders) {
-		$FolderName = (Get-Item "$Folder").Name
-		$Step++
-		Write-Host "⏳ ($Step/$($NumFolders + 2)) Fetching into 📂$FolderName...  "
-
-		& git -C "$Folder" fetch --all --recurse-submodules --prune --prune-tags --force
-		if ($lastExitCode -ne "0") { throw "'git fetch' in $Folder failed with exit code $lastExitCode" }
-	}
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ Fetching updates into $NumFolders repositories under 📂$ParentDirName took $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of fetch-repos.ps1 as of 08/06/2023 21:36:07)*

Docs/install-basic-apps.md

@@ -1,92 +0,0 @@
-*install-basic-apps.ps1*
-================
-
-This PowerShell script installs basic Windows apps such as browser, e-mail client, etc.
-NOTE: Apps from Microsoft Store are preferred (due to security and automatic updates).
-
-Parameters
-----------
-```powershell
-PS> ./install-basic-apps.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./install-basic-apps.ps1
-⏳ (1/37) Loading Data/basic-apps.csv...            35 apps
-⏳ (2/37) These apps will be installed or upgraded: 7-Zip · Aquile Reader ...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Installs basic apps
-.DESCRIPTION
-	This PowerShell script installs basic Windows apps such as browser, e-mail client, etc.
-	NOTE: Apps from Microsoft Store are preferred (due to security and automatic updates). 
-.EXAMPLE
-	PS> ./install-basic-apps.ps1
-	⏳ (1/37) Loading Data/basic-apps.csv...            35 apps
-	⏳ (2/37) These apps will be installed or upgraded: 7-Zip · Aquile Reader ...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	Write-Host "⏳ (1/37) Loading Data/basic-apps.csv...            " -noNewline
-	$Table = Import-CSV "$PSScriptRoot/../Data/basic-apps.csv"
-	$NumEntries = $Table.count
-	"$NumEntries apps"
-	Write-Host "⏳ (2/37) These apps will be installed or upgraded: " -noNewline
-	foreach($Row in $Table) {
-		[string]$AppName = $Row.APPLICATION
-		Write-Host "$AppName · " -noNewline
-	}
-	""
-	""
-	"Installation will start in 15 seconds... (otherwise press <Control> <C> to abort)"
-	Start-Sleep -seconds 15
-
-	[int]$Step = 3
-	[int]$Skipped = 0
-	foreach($Row in $Table) {
-		[string]$AppName = $Row.APPLICATION
-		[string]$Category = $Row.CATEGORY
-		[string]$AppID = $Row.APPID
-		Write-Host " "
-		Write-Host "⏳ ($Step/$($NumEntries + 2)) Installing $Category '$AppName'..."
-		& winget install --id $AppID --accept-package-agreements --accept-source-agreements
-        	if ($lastExitCode -ne "0") { $Skipped++ }
-		$Step++
-	}
-	[int]$Installed = ($NumEntries - $Skipped)
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ Installation of $Installed basic apps ($Skipped skipped) took $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of install-basic-apps.ps1 as of 08/06/2023 21:36:07)*

Docs/install-calibre-server.md

@@ -1,108 +0,0 @@
-*install-calibre-server.ps1*
-================
-
-This PowerShell script installs and starts a local Calibre server as background process (using Web port 8099 by default).
-
-Parameters
-----------
-```powershell
-PS> ./install-calibre-server.ps1 [[-Port] <Int32>] [[-UserDB] <String>] [[-Logfile] <String>] [<CommonParameters>]
-
--Port <Int32>
-    Specifies the Web port number (8099 by default)
-    
-    Required?                    false
-    Position?                    1
-    Default value                8099
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--UserDB <String>
-    
-    Required?                    false
-    Position?                    2
-    Default value                "$HOME/CalibreUsers.sqlite"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--Logfile <String>
-    
-    Required?                    false
-    Position?                    3
-    Default value                "$HOME/CalibreServer.log"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./install-calibre-server.ps1
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Installs Calibre server (needs admin rights)
-.DESCRIPTION
-	This PowerShell script installs and starts a local Calibre server as background process (using Web port 8099 by default).
-.PARAMETER port
-	Specifies the Web port number (8099 by default)
-.EXAMPLE
-	PS> ./install-calibre-server.ps1
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-#Requires -RunAsAdministrator
-
-param([int]$Port = 8099, [string]$UserDB = "$HOME/CalibreUsers.sqlite", [string]$Logfile = "$HOME/CalibreServer.log")
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	"⏳ (1/5) Updating package infos..."
-	& sudo apt update -y
-	if ($lastExitCode -ne "0") { throw "'apt update' failed" }
-
-	"⏳ (2/5) Installing the Calibre package..."
-	& sudo apt install calibre -y
-	if ($lastExitCode -ne "0") { throw "'apt install calibre' failed" }
-
-	"⏳ (3/5) Searching for Calibre server executable..."
-	& calibre-server --version
-	if ($lastExitCode -ne "0") { throw "Can't execute 'calibre-server' - make sure Calibre server is installed and available" }
-
-	"⏳ (4/5) Creating folder 'Calibre Library' in your home directory..."
-	mkdir $HOME/'Calibre Library'
-
-	"⏳ (5/5) Starting Calibre server as background process..."
-	& calibre-server --port $Port --num-per-page 100 --userdb $UserDB --log $Logfile --daemonize $HOME/'Calibre Library'
-
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ installed Calibre in $Elapsed sec (Web port $Port, user DB at $UserDB, log file at $Logfile)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of install-calibre-server.ps1 as of 08/06/2023 21:36:07)*

Docs/install-github-cli.md

@@ -1,55 +0,0 @@
-*install-github-cli.ps1*
-================
-
-
-
-Parameters
-----------
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Installs GitHub CLI
-.DESCRIPTION
-	This PowerShell script installs GitHub command-line interface (CLI).
-.EXAMPLE
-	PS> ./install-github-cli.ps1
-	✔ GitHub CLI installed successfully in 9 sec
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	if ($IsMacOS) {
-		& brew install gh
-	} elseif ($IsLinux) {
-		curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg
-		echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
-		sudo apt update
-		sudo apt install gh
-	} else {
-		& winget install --id GitHub.cli
-
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ GitHub CLI installed successfully in $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of install-github-cli.ps1 as of 08/06/2023 21:36:12)*

Docs/install-updates.md

@@ -1,79 +0,0 @@
-*install-updates.ps1*
-================
-
-This PowerShell script installs software updates for the local machine (needs admin rights).
-Use the script 'list-updates.ps1' to list available updates.
-
-Parameters
-----------
-```powershell
-PS> ./install-updates.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./install-updates.ps1
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Installs updates
-.DESCRIPTION
-	This PowerShell script installs software updates for the local machine (needs admin rights).
-	Use the script 'list-updates.ps1' to list available updates.
-.EXAMPLE
-	PS> ./install-updates.ps1
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	if ($IsLinux) {
-		"⏳ (1/4) Querying updates for installed Debian packages..."
-		& sudo apt update
-
-		"⏳ (2/4) Upgrading installed Debian packages..."
-		& sudo apt upgrade --yes
-
-		"⏳ (3/4) Removing obsolete Debian packages..."
-		& sudo apt autoremove --yes
-
-		"⏳ (4/4) Upgrading installed Snap packages..."
-		& sudo snap refresh
-	} else {
-		Write-Progress "⏳ Installing updates..."
-		" "
-		& winget upgrade --all
-		Write-Progress -completed " "
-	}
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✅ installed the updates in $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of install-updates.ps1 as of 08/06/2023 21:36:12)*

Docs/introduce-powershell.md

@@ -1,89 +0,0 @@
-*introduce-powershell.ps1*
-================
-
-This PowerShell script introduces PowerShell to new users.
-
-Parameters
-----------
-```powershell
-PS> ./introduce-powershell.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./introduce-powershell.ps1
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Introduces PowerShell to new users
-.DESCRIPTION
-	This PowerShell script introduces PowerShell to new users.
-.EXAMPLE
-	PS> ./introduce-powershell.ps1
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	Clear-Host
-	""
-	& "$PSScriptRoot/write-animated.ps1" "Welcome to"
-	""
-	& "$PSScriptRoot/write-big.ps1" "     POWERSHELL"
-	""
-	& "$PSScriptRoot/write-animated.ps1" "May the force be with you!"
-	""
-	""
-	""
-	$Version = $PSVersionTable.PSVersion
-	$Edition = $PSVersionTable.PSEdition
-	$NumModules = (Get-Module).Count
-	$NumAliases = (Get-Alias).Count
-	$Details = "PowerShell $Version ($Edition edition) with $NumModules modules and $NumAliases aliases"
-	Write-Host "🔸 " -noNewline
-	& "$PSScriptRoot/write-typewriter.ps1" "This is $Details" 25
-	""
-	Write-Host "🔸 " -noNewline
-	& "$PSScriptRoot/write-typewriter.ps1" "Want to learn PowerShell? See the tutorials at: https://www.guru99.com/powershell-tutorial.html" 25
-	""
-	Write-Host "🔸 " -noNewline
-	& "$PSScriptRoot/write-typewriter.ps1" "Need docs? See the official documentation at: https://docs.microsoft.com/en-us/powershell" 25
-	""
-	Write-Host "🔸 " -noNewline
-	& "$PSScriptRoot/write-typewriter.ps1" "Take a look under the hood and visit the PowerShell Github repository at: https://github.com/PowerShell/PowerShell" 25
-	""
-	Write-Host "🔸 " -noNewline
-	& "$PSScriptRoot/write-typewriter.ps1" "Want examples? See the mega collection of PowerShell scripts at: https://github.com/fleschutz/PowerShell" 25
-	""
-
-	& "$PSScriptRoot/write-typewriter.ps1" "NOTE: use <Ctrl> + <Click> to follow the links above and HAVE FUN!" 20
-	""
-
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of introduce-powershell.ps1 as of 08/06/2023 21:36:12)*

Docs/list-city-weather.md

@@ -1,66 +0,0 @@
-*list-city-weather.ps1*
-================
-
-This PowerShell script lists the current weather of cities world-wide (west to east).
-
-Parameters
-----------
-```powershell
-PS> ./list-city-weather.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-city-weather.ps1
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists current weather of cities world-wide 
-.DESCRIPTION
-	This PowerShell script lists the current weather of cities world-wide (west to east).
-.EXAMPLE
-	PS> ./list-city-weather.ps1
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-$Cities="Hawaii","Los Angeles","Mexico City","Dallas","Miami","New York","Rio de Janeiro","Paris","London","Berlin","Cape Town","Dubai","Mumbai","Singapore","Hong Kong","Perth","Peking","Tokyo","Sydney"
-
-function ListCityWeather {
-	foreach($City in $Cities) {
-		$Conditions = (Invoke-WebRequest http://wttr.in/${City}?format="%c  +%t`t+%p`t+%h`t+%P  +%w" -UserAgent "curl" -useBasicParsing).Content
-		$Sun = (Invoke-WebRequest http://wttr.in/${City}?format="+%S →+%s" -UserAgent "curl" -useBasicParsing).Content
-		New-Object PSObject -Property @{ City="$City"; Conditions="$Conditions"; Sun="$Sun" }
-	}
-}
-
-try {
-	ListCityWeather | Format-Table -property City,Conditions,Sun
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-city-weather.ps1 as of 08/06/2023 21:36:12)*

Docs/list-dir-tree.md

@@ -1,108 +0,0 @@
-*list-dir-tree.ps1*
-================
-
-This PowerShell script lists all files and folders in a directory tree.
-
-Parameters
-----------
-```powershell
-PS> ./list-dir-tree.ps1 [[-DirTree] <String>] [<CommonParameters>]
-
--DirTree <String>
-    Specifies the path to the directory tree
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-dir-tree.ps1 C:\
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists a directory tree
-.DESCRIPTION
-	This PowerShell script lists all files and folders in a directory tree.
-.PARAMETER DirTree
-	Specifies the path to the directory tree
-.EXAMPLE
-	PS> ./list-dir-tree.ps1 C:\
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$DirTree = "$PWD")
-
-function GetFileIcon { param([string]$Suffix)
-	switch ($Suffix) {
-	".csv"	{return "📊"}
-	".epub"	{return "📓"}
-	".exe"  {return "⚙️"}
-	".gif"	{return "📸"}
-	".iso"	{return "📀"}
-	".jpg"	{return "📸"}
-	".mp3"	{return "🎵"}
-	".mkv"	{return "🎬"}
-	".zip"  {return "🎁"}
-	default {return "📄"}
-	}
-}
-
-function ListDir { param([string]$Directory, [int]$Depth)
-	$Depth++
-	$Items = Get-ChildItem -path $Directory
-	foreach($Item in $Items) {
-		$Filename = $Item.Name
-		for ($i = 1; $i -lt $Depth; $i++) { Write-Host "│ " -noNewline }
-		if ($Item.Mode -like "d*") {
-			Write-Host "├" -noNewline
-			Write-Host -foregroundColor green "📂$Filename"
-			ListDir "$Directory\$Filename" $Depth
-			$global:Dirs++
-		} else {
-			$Icon = GetFileIcon $Item.Extension
-			Write-Host "├$($Icon)$Filename ($($Item.Length) bytes)"
-			$global:Files++
-			$global:Bytes += $Item.Length
-		}
-	}
-}
-
-try {
-	[int]$global:Dirs = 1
-	[int]$global:Files = 0
-	[int]$global:Bytes = 0
-	ListDir $DirTree 0
-	" ($($global:Dirs) folders, $($global:Files) files, $($global:Bytes) bytes in total)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-dir-tree.ps1 as of 08/06/2023 21:36:13)*

Docs/list-dns-servers.md

@@ -1,65 +0,0 @@
-*list-dns-servers.ps1*
-================
-
-list-dns-servers.ps1 
-
-
-Parameters
-----------
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists DNS servers
-.DESCRIPTION
-	This PowerShell script measures the latency of public and free DNS servers and lists it.
-.EXAMPLE
-	PS> ./list-dns-servers.ps1
-      
-	Provider                IPv4                             Latency
-	--------                ----                             -------
-	AdGuard DNS (Cyprus)    94.140.14.14 / 94.140.15.15      222 / 205 ms
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-function CheckDNSServer { param($Provider, $IPv4Pri, $IPv4Sec)
-	Write-Progress "Measuring latency of $Provider..."
-	$SW=[system.diagnostics.stopwatch]::startNew();$null=(nslookup fleschutz.de $IPv4Pri 2>$null);[int]$Lat1=$SW.Elapsed.TotalMilliseconds
-
-	$SW=[system.diagnostics.stopwatch]::startNew();$null=(nslookup fleschutz.de $IPv4Sec 2>$null);[int]$Lat2=$SW.Elapsed.TotalMilliseconds
-
-	New-Object PSObject -Property @{ Provider=$Provider; IPv4="$IPv4Pri / $IPv4Sec"; Latency="$Lat1 / $Lat2 ms" }
-}
-
-function List-DNS-Servers {
-	Write-Progress "Loading Data/public-dns-servers.csv..."
-      $Table = Import-CSV "$PSScriptRoot/../Data/public-dns-servers.csv"
-	foreach($Row in $Table) {
-		CheckDNSServer $Row.PROVIDER $Row.IPv4_PRI $Row.IPv4_SEC	
-	}
-	Write-Progress -completed "."
-}
- 
-try {
-	List-DNS-Servers | Format-Table -property @{e='Provider';width=50},@{e='IPv4';width=32},@{e='Latency';width=15}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-dns-servers.ps1 as of 08/06/2023 21:36:13)*

Docs/list-empty-dirs.md

@@ -1,80 +0,0 @@
-*list-empty-dirs.ps1*
-================
-
-This PowerShell script scans and lists all empty subfolders within the given directory tree.
-
-Parameters
-----------
-```powershell
-PS> ./list-empty-dirs.ps1 [[-DirTree] <String>] [<CommonParameters>]
-
--DirTree <String>
-    Specifies the path to the directory tree (current working directory by default)
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-empty-dirs.ps1 C:\
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists empty subfolders
-.DESCRIPTION
-	This PowerShell script scans and lists all empty subfolders within the given directory tree.
-.PARAMETER DirTree
-	Specifies the path to the directory tree (current working directory by default)
-.EXAMPLE
-	PS> ./list-empty-dirs.ps1 C:\
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$DirTree = "$PWD")
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	$DirTree = Resolve-Path "$DirTree"
-	Write-Progress "Listing empty subfolders in $DirTree..."
-	[int]$Count = 0
-	Get-ChildItem "$DirTree" -attributes Directory -recurse | Where {$_.GetFileSystemInfos().Count -eq 0} | ForEach-Object {
-		"📂$($_.FullName)"
-		$Count++
-	}
-
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ found $Count empty subfolders within directory tree $DirTree in $Elapsed sec." 
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-empty-dirs.ps1 as of 08/06/2023 21:36:13)*

Docs/list-empty-files.md

@@ -1,78 +0,0 @@
-*list-empty-files.ps1*
-================
-
-This PowerShell script scans and lists all empty files within the given directory tree.
-
-Parameters
-----------
-```powershell
-PS> ./list-empty-files.ps1 [[-DirTree] <String>] [<CommonParameters>]
-
--DirTree <String>
-    Specifies the path to the directory tree
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-empty-files.ps1 C:\
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists empty files within a directory tree
-.DESCRIPTION
-	This PowerShell script scans and lists all empty files within the given directory tree.
-.PARAMETER DirTree
-	Specifies the path to the directory tree
-.EXAMPLE
-	PS> ./list-empty-files.ps1 C:\
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$DirTree = "")
-
-try {
-	if ($DirTree -eq "" ) { $DirTree = read-host "Enter the path to the directory tree" }
-
-	[int]$Count = 0
-	write-progress "Listing empty files in $DirTree ..."
-	get-childItem $DirTree -attributes !Directory -recurse | where {$_.Length -eq 0} | foreach-object {
-		write-output $_.FullName
-		$Count++
-	}
-
-	"✔️ found $Count empty file(s)" 
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-empty-files.ps1 as of 08/06/2023 21:36:13)*

Docs/list-hidden-files.md

@@ -1,77 +0,0 @@
-*list-hidden-files.ps1*
-================
-
-This PowerShell script scans and lists all hidden files in a directory tree.
-
-Parameters
-----------
-```powershell
-PS> ./list-hidden-files.ps1 [[-DirTree] <String>] [<CommonParameters>]
-
--DirTree <String>
-    Specifies the path to the directory tree
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-hidden-files.ps1 C:\
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists hidden files in a directory tree
-.DESCRIPTION
-	This PowerShell script scans and lists all hidden files in a directory tree.
-.PARAMETER DirTree
-	Specifies the path to the directory tree
-.EXAMPLE
-	PS> ./list-hidden-files.ps1 C:\
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$DirTree = "$PWD")
-
-try {
-	$DirTree = resolve-path "$DirTree"
-	write-progress "Listing hidden files in $DirTree ..."
-
-	[int]$Count = 0
-	get-childItem "$DirTree" -attributes Hidden -recurse | foreach-object {
-		"📄 $($_.FullName)"
-		$Count++
-	}
-	"✔️ directory tree $DirTree has $Count hidden file(s)" 
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-hidden-files.ps1 as of 08/06/2023 21:36:13)*

Docs/list-memos.md

@@ -1,74 +0,0 @@
-*list-memos.ps1*
-================
-
-This PowerShell script lists all memo entries in Memos.csv in your home folder.
-
-Parameters
-----------
-```powershell
-PS> ./list-memos.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-memos.ps1
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists your memo entries
-.DESCRIPTION
-	This PowerShell script lists all memo entries in Memos.csv in your home folder.
-.EXAMPLE
-	PS> ./list-memos.ps1
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-
-try {
-	$Path = "~/Memos.csv"
-	if (Test-Path "$Path" -pathType leaf) {
-		write-progress "Reading $Path ..."
-		$Table = Import-CSV "$Path"
-		write-progress -completed "Reading $Path"
-
-		""
-		"Time                  Text"
-		"----                  ----"
-		foreach($Row in $Table) {
-			$Time = $Row.Time
-			$Text = $Row.Text
-			"$Time  $Text"
-		}
-	} else {
-		"Sorry, no memos saved yet"
-		exit 1
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-memos.ps1 as of 08/06/2023 21:36:13)*

Docs/list-news.md

@@ -1,110 +0,0 @@
-*list-news.ps1*
-================
-
-This PowerShell script lists the latest news by using RSS (Really Simple Syndication) feeds.
-
-Parameters
-----------
-```powershell
-PS> ./list-news.ps1 [[-RSS_URL] <String>] [[-MaxLines] <Int32>] [[-Speed] <Int32>] [<CommonParameters>]
-
--RSS_URL <String>
-    Specifies the URL to the RSS feed (Yahoo News by default)
-    
-    Required?                    false
-    Position?                    1
-    Default value                https://yahoo.com/news/rss/world
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--MaxLines <Int32>
-    Specifies the maximum number of lines to list (24 by default)
-    
-    Required?                    false
-    Position?                    2
-    Default value                24
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--Speed <Int32>
-    Specifies the speed to write the text (10 ms by default)
-    
-    Required?                    false
-    Position?                    3
-    Default value                10
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-news.ps1
-❇️ Deadly Mediterranean wildfires kill more than 40
-...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	List the latest news
-.DESCRIPTION
-	This PowerShell script lists the latest news by using RSS (Really Simple Syndication) feeds.
-.PARAMETER RSS_URL
-	Specifies the URL to the RSS feed (Yahoo News by default)
-.PARAMETER MaxLines
-	Specifies the maximum number of lines to list (24 by default)
-.PARAMETER Speed
-        Specifies the speed to write the text (10 ms by default)
-.EXAMPLE
-	PS> ./list-news.ps1
-	❇️ Deadly Mediterranean wildfires kill more than 40
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$RSS_URL = "https://yahoo.com/news/rss/world", [int]$MaxLines = 24, [int]$Speed = 10)
-
-try {
-	[xml]$Content = (Invoke-WebRequest -URI $RSS_URL -useBasicParsing).Content
-	[int]$Count = 1
-	foreach ($Item in $Content.rss.channel.item) {
-		& "$PSScriptRoot/write-typewriter.ps1" "❇️ $($Item.title)" $Speed
-		if ($Count++ -eq $MaxLines) { break }
-	}
-	$Source = $Content.rss.channel.title
-	$Date = $Content.rss.channel.pubDate
-	$Date = $Date -Replace "Mon, ",""
-	$Date = $Date -Replace "Tue, ",""
-	$Date = $Date -Replace "Wed, ",""
-	$Date = $Date -Replace "Thu, ",""
-	$Date = $Date -Replace "Fri, ",""
-	$Date = $Date -Replace "Sat, ",""
-	$Date = $Date -Replace "Sun, ",""
-	"(by $Source as of $Date)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-news.ps1 as of 08/06/2023 21:36:13)*

Docs/list-repos.md

@@ -1,105 +0,0 @@
-*list-repos.ps1*
-================
-
-This PowerShell script lists details of all Git repositories in a folder.
-
-Parameters
-----------
-```powershell
-PS> ./list-repos.ps1 [[-ParentDir] <String>] [<CommonParameters>]
-
--ParentDir <String>
-    Specifies the path to the parent directory.
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-repos C:\MyRepos
-
-
-
-Repository   Latest Tag   Branch    Updates  Status
-----------   ----------   ------    -------  ------
-📂cmake      v3.23.0      🌵main    ↓0       ✔️clean
-...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists Git repos
-.DESCRIPTION
-	This PowerShell script lists details of all Git repositories in a folder.
-.PARAMETER ParentDir
-	Specifies the path to the parent directory.
-.EXAMPLE
-	PS> ./list-repos C:\MyRepos
-	
-	Repository   Latest Tag   Branch    Updates  Status
-	----------   ----------   ------    -------  ------
-	📂cmake      v3.23.0      🌵main    ↓0       ✔️clean
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$ParentDir = "$PWD")
-
-function ListRepos { 
-	$Folders = (Get-ChildItem "$ParentDir" -attributes Directory)
-	foreach($Folder in $Folders) {
-		$Repository = (Get-Item "$Folder").Name
-		$LatestTagCommitID = (git -C "$Folder" rev-list --tags --max-count=1)
-		if ($LatestTagCommitID -ne "") {
-	        	$LatestTag = (git -C "$Folder" describe --tags $LatestTagCommitID)
-		} else {
-			$LatestTag = ""
-		}
-		$Branch = (git -C "$Folder" branch --show-current)
-		$NumCommits = (git -C "$Folder" rev-list HEAD...origin/$Branch --count)
-		$Status = (git -C "$Folder" status --short)
-		if ("$Status" -eq "") { $Status = "✔️clean" }
-		elseif ("$Status" -like " M *") { $Status = "⚠️modified" }
-		New-Object PSObject -property @{'Repository'="📂$Repository";'Latest Tag'="$LatestTag";'Branch'="🌵$Branch";'Updates'="↓$NumCommits";'Status'="$Status";}
-	}
-}
-
-try {
-	if (-not(Test-Path "$ParentDir" -pathType container)) { throw "Can't access directory: $ParentDir" }
-
-	$Null = (git --version)
-	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
-
-	ListRepos | Format-Table -property @{e='Repository';width=20},@{e='Latest Tag';width=18},@{e='Branch';width=20},@{e='Updates';width=8},Status
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-repos.ps1 as of 08/06/2023 21:36:13)*

Docs/list-scripts.md

@@ -1,57 +0,0 @@
-*list-scripts.ps1*
-================
-
-list-scripts.ps1 
-
-
-Parameters
-----------
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists all PowerShell scripts
-.DESCRIPTION
-	This PowerShell script lists all PowerShell scripts in the repository (sorted alphabetically).
-.EXAMPLE
-	PS> ./list-scripts.ps1
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-function ListScripts { param([string]$FilePath)
-	Write-Progress "Reading $FilePath..."
-	$table = Import-CSV "$FilePath"
-	[int]$No = 1
-	foreach($row in $table) {
-		New-Object PSObject -Property @{
-			'No' = $No++
-			'Script' = $row.SCRIPT
-			'Description' = $row.DESCRIPTION
-		}
-	}
-	$global:NumScripts = $Table.Count
-	Write-Progress -completed "."
-}
-
-try {
-	ListScripts "$PSScriptRoot/../Data/scripts.csv" | Format-Table -property No,Script,Description
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-scripts.ps1 as of 08/06/2023 21:36:13)*

Docs/list-special-folders.md

@@ -1,95 +0,0 @@
-*list-special-folders.ps1*
-================
-
-list-special-folders.ps1 
-
-
-Parameters
-----------
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists special folders
-.DESCRIPTION
-	This PowerShell script lists all special folders (sorted alphabetically).
-.EXAMPLE
-	PS> ./list-special-folders.ps1
-
-	Folder Name     Folder Path
-	-----------     -----------
-	AdminTools      📂C:\Users\Markus\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Administrative Tools
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-function GetTempDir {
-        if ("$env:TEMP" -ne "") { return "$env:TEMP" }
-        if ("$env:TMP" -ne "")  { return "$env:TMP" }
-        if ($IsLinux) { return "/tmp/" }
-        return "C:\Temp"
-}
-
-function AddLine { param([string]$FolderName, [string]$FolderPath)
-	if (Test-Path "$FolderPath" -pathType container) {
-		New-Object PSObject -property @{ 'Folder Name' = "$FolderName"; 'Folder Path' = "📂$FolderPath" }
-	}
-}
-
-function ListSpecialFolders {
-	if ($IsLinux) {
-		AddLine "Desktop"          "$HOME/Desktop/"
-		AddLine "Documents"        "$HOME/Documents/"
-		AddLine "Downloads"        "$HOME/Downloads/"
-		AddLine "Dropbox"          "$HOME/Dropbox/"
-		AddLine "Home"             "$HOME/"
-		AddLine "Music"            "$HOME/Music/"
-		AddLine "Pictures"         "$HOME/Pictures/"
-		AddLine "Repositories"     "$HOME/Repos/"
-		AddLine "Repositories"     "$HOME/Repositories/"
-		AddLine "Screenshots"      "$HOME/Pictures/Screenshots/"
-		AddLine "Snap"             "$HOME/snap/"
-		AddLine "SSH"              "$HOME/.ssh/"
-		AddLine "Trash"            "$HOME/.local/share/Trash/"
-		AddLine "Templates"        "$Home/Templates/"
-		AddLine "Temporary"        "$(GetTempDir)"
-		$Path = Resolve-Path "$HOME/.."
-		AddLine "Users"            "$Path/"
-		AddLine "Videos"           "$HOME/Videos/"
-	} else {
-		$FolderNames = [System.Enum]::GetNames('System.Environment+SpecialFolder')
-		$FolderNames | Sort-Object | ForEach-Object {
-			if ($Path = [System.Environment]::GetFolderPath($_)) {
-				AddLine "$_" "$Path"
-			}
-		}
-		AddLine "Repositories"     "$HOME\source\repos"
-		AddLine "SSH"              "$HOME\.ssh"
-		AddLine "Temporary"        "$(GetTempDir)"
-		$Path = Resolve-Path "$HOME/.."
-		AddLine "Users"            "$Path"
-	}
-}
-
-try {
-	ListSpecialFolders | Format-Table -property @{e='Folder Name';width=18},'Folder Path'
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-special-folders.ps1 as of 08/06/2023 21:36:13)*

Docs/list-unused-files.md

@@ -1,85 +0,0 @@
-*list-unused-files.ps1*
-================
-
-This PowerShell script scans and lists files in a folder with last access time older than number of days.
-
-Parameters
-----------
-```powershell
-PS> ./list-unused-files.ps1 [[-DirTree] <String>] [[-Days] <Int32>] [<CommonParameters>]
-
--DirTree <String>
-    Specifies the path to the directory tree
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--Days <Int32>
-    Specifies the number of days
-    
-    Required?                    false
-    Position?                    2
-    Default value                100
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-unused-files.ps1 C:\ 100
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists unused files in a directory tree
-.DESCRIPTION
-	This PowerShell script scans and lists files in a folder with last access time older than number of days.
-.PARAMETER DirTree
-	Specifies the path to the directory tree
-.PARAMETER Days
-	Specifies the number of days
-.EXAMPLE
-	PS> ./list-unused-files.ps1 C:\ 100
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$DirTree = "", [int]$Days = 100)
-
-write-host "Listing files in $DirTree with last access time older than $Days days"
-
-try {
-	$cutOffDate = (Get-Date).AddDays(-$Days)
-
-	Get-ChildItem -path $DirTree -recurse | Where-Object {$_.LastAccessTime -le $cutOffDate} | select fullname
-
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-unused-files.ps1 as of 08/06/2023 21:36:14)*

Docs/list-updates.md

@@ -1,82 +0,0 @@
-*list-updates.ps1*
-================
-
-This PowerShell script queries and lists available software updates for the local machine.
-Use 'install-updates.ps1' to install the listed updates.
-
-Parameters
-----------
-```powershell
-PS> ./list-updates.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-updates.ps1
-
-
-
-Name                   Id                                Version       Available        Source
---------------------------------------------------------------------------------------------------
-Git                    Git.Git                           2.41.0        2.41.0.2         winget
-       ...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists new software updates
-.DESCRIPTION
-	This PowerShell script queries and lists available software updates for the local machine.
-	Use 'install-updates.ps1' to install the listed updates.
-.EXAMPLE
-	PS> ./list-updates.ps1
-
-	Name                   Id                                Version       Available        Source
-	--------------------------------------------------------------------------------------------------
-	Git                    Git.Git                           2.41.0        2.41.0.2         winget
-        ...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	if ($IsLinux) {
-		"⏳ (1/2) Querying package updates..."
-		& sudo apt update
-		& sudo apt list --upgradable
-		"⏳ (2/2) Querying Snap updates..."
-		& sudo snap refresh --list
-	} else {
-		" "
-		Write-Progress "⏳ Querying new software updates..."
-		& winget upgrade
-		Write-Progress -completed "."
-	}
-	"(use 'install-updates.ps1' to install the listed updates)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-updates.ps1 as of 08/06/2023 21:36:14)*

Docs/list-weather.md

@@ -1,170 +0,0 @@
-*list-weather.ps1*
-================
-
-This PowerShell script lists the hourly weather report in a nice table.
-
-Parameters
-----------
-```powershell
-PS> ./list-weather.ps1 [[-Location] <String>] [<CommonParameters>]
-
--Location <String>
-    Specifies the location to use (determined automatically per default)
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./list-weather.ps1
-TODAY   🌡°C  ☂️mm  💧  💨km/h ☀️UV  ☁️  👁km  at Munich (Bayern, Germany)
- 0°°   -2°   0.0   93%   ↗ 6   1    21%  10  🌙 clear
-...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Lists the weather report
-.DESCRIPTION
-	This PowerShell script lists the hourly weather report in a nice table.
-.PARAMETER Location
-	Specifies the location to use (determined automatically per default)
-.EXAMPLE
-	PS> ./list-weather.ps1
-	TODAY   🌡°C  ☂️mm  💧  💨km/h ☀️UV  ☁️  👁km  at Munich (Bayern, Germany)
-	 0°°   -2°   0.0   93%   ↗ 6   1    21%  10  🌙 clear
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$Location = "") # empty means determine automatically
-
-function GetDescription { param([string]$Text)
-	switch($Text) {
-	"Blizzard"			{ return "❄️ blizzard ⚠️" }
-	"Blowing snow"			{ return "❄️ blowing snow ⚠️" }
-	"Clear"				{ return "🌙 clear" }
-	"Cloudy"			{ return "☁️ cloudy" }
-	"Fog"				{ return "🌫  fog" }
-	"Freezing fog"			{ return "🌫  freezing fog" }
-	"Heavy snow"			{ return "❄️ heavy snow ⚠️" }
-	"Light drizzle"			{ return "💧 light drizzle" }
-	"Light freezing rain"		{ return "💧 light freezing rain ⚠️" }
-	"Light rain"			{ return "💧 light rain" }
-	"Light rain shower"		{ return "💧 light rain shower" }
-	"Light sleet"			{ return "❄️ light sleet" }
-	"Light sleet showers"		{ return "❄️ light sleet showers" }
-	"Light snow"			{ return "❄️ light snow" }
-	"Light snow showers"		{ return "❄️ light snow showers" }
-	"Moderate or heavy snow showers"{ return "❄️ moderate or heavy snow showers ⚠️" }
-	"Moderate or heavy freezing rain"{ return "💧 moderate or heavy freezing rain ⚠️" }
-	"Moderate rain"			{ return "💧 moderate rain" }
-	"Moderate rain at times"	{ return "💧 moderate rain at times" }
-	"Moderate snow"			{ return "❄️ moderate snow" }
-	"Mist"				{ return "🌫  misty" }
-	"Overcast"			{ return "☁️ overcast" }
-	"Partly cloudy"			{ return "⛅️partly cloudy" }
-	"Patchy heavy snow"		{ return "❄️ patchy heavy snow ⚠️" }
-	"Patchy light drizzle"     	{ return "💧 patchy light drizzle" }
-	"Patchy light rain"     	{ return "💧 patchy light rain" }
-	"Patchy light rain with thunder" { return "💧 patchy light rain with thunder" }
-	"Patchy light snow"		{ return "❄️ patchy light snow" }
-	"Patchy moderate snow"		{ return "❄️ patchy moderate snow" }
-	"Patchy rain possible"  	{ return "💧 patchy rain possible" }
-	"Patchy snow possible"  	{ return "❄️ patchy snow possible" }
-	"Sunny"				{ return "☀️ sunny" }
-	"Thundery outbreaks possible"	{ return "⚡️thundery outbreaks possible" }
-	default				{ return "$Text" }
-	}
-}
-
-function GetWindDir { param([string]$Text)
-	switch($Text) {
-	"NW"	{ return "↘" }
-	"NNW"	{ return "↓" }
-	"N"	{ return "↓" }
-	"NNE"	{ return "↓" }
-	"NE"	{ return "↙" }
-	"ENE"	{ return "←" }
-	"E"	{ return "←" }
-	"ESE"	{ return "←" }
-	"SE"	{ return "↖" }
-	"SSE"	{ return "↑" }
-	"S"	{ return "↑" }
-	"SSW"	{ return "↑" }
-	"SW"	{ return "↗" }
-	"WSW"	{ return "→" }
-	"W"	{ return "→" }
-	"WNW"	{ return "→" }
-	default { return "$Text" }
-	}
-}
-
-try {
-	Write-Progress "⏳ Loading weather data from http://wttr.in ..."
-	$Weather = (Invoke-WebRequest -URI http://wttr.in/${Location}?format=j1 -userAgent "curl" -useBasicParsing).Content | ConvertFrom-Json
-	Write-Progress -completed "."
-	$Area = $Weather.nearest_area.areaName.value
-	$Region = $Weather.nearest_area.region.value
-	$Country = $Weather.nearest_area.country.value	
-	[int]$Day = 0
-	foreach($Hourly in $Weather.weather.hourly) {
-		$Hour = $Hourly.time / 100
-		$Temp = $(($Hourly.tempC.toString()).PadLeft(3))
-		$Precip = $Hourly.precipMM
-		$Humidity = $(($Hourly.humidity.toString()).PadLeft(3))
-		$Pressure = $Hourly.pressure
-		$WindSpeed = $(($Hourly.windspeedKmph.toString()).PadLeft(2))
-		$WindDir = GetWindDir $Hourly.winddir16Point
-		$UV = $Hourly.uvIndex
-		$Clouds = $(($Hourly.cloudcover.toString()).PadLeft(3))
-		$Visib = $(($Hourly.visibility.toString()).PadLeft(2))
-		$Desc = GetDescription $Hourly.weatherDesc.value
-		if ($Hour -eq 0) {
-			if ($Day -eq 0) {
-				Write-Host -foregroundColor green "TODAY   🌡°C  ☂️mm  💧  💨km/h  ☀️UV  ☁️   👁km   at $Area ($Region, $Country)"
-			} elseif ($Day -eq 1) {
-				$Date = (Get-Date).AddDays(1)
-				[string]$Weekday = $Date.DayOfWeek
-				Write-Host -foregroundColor green "$($Weekday.toUpper())"
-			} else {
-				$Date = (Get-Date).AddDays(2)
-				[string]$Weekday = $Date.DayOfWeek
-				Write-Host -foregroundColor green "$($Weekday.toUpper())"
-			}
-			$Day++
-		}
-		"$(($Hour.toString()).PadLeft(2))°°  $Temp°   $Precip  $Humidity%   $($WindDir)$WindSpeed    $UV   $Clouds%   $Visib   $Desc"
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of list-weather.ps1 as of 08/06/2023 21:36:14)*

Docs/locate-city.md

@@ -1,90 +0,0 @@
-*locate-city.ps1*
-================
-
-This PowerShell script prints the geographic location of the given city.
-
-Parameters
-----------
-```powershell
-PS> ./locate-city.ps1 [[-City] <String>] [<CommonParameters>]
-
--City <String>
-    Specifies the city to look for
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./locate-city.ps1 Paris
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Prints the geographic location of a city
-.DESCRIPTION
-	This PowerShell script prints the geographic location of the given city.
-.PARAMETER City
-	Specifies the city to look for
-.EXAMPLE
-	PS> ./locate-city.ps1 Paris
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$City = "")
-
-try {
-	if ($City -eq "" ) { $City = Read-Host "Enter the city name" }
-
-	Write-Progress "Reading worldcities.csv..."
-	$Table = import-csv "$PSScriptRoot/../Data/worldcities.csv"
-
-	$FoundOne = 0
-	foreach($Row in $Table) {
-		if ($Row.city -eq $City) {
-			$FoundOne = 1
-			$Country = $Row.country
-			$Region = $Row.admin_name
-			$Lat = $Row.lat
-			$Long = $Row.lng
-			$Population = $Row.population
-			write-host "* $City ($Country, $Region, population $Population) is at $Lat°N, $Long°W"
-		}
-	}
-
-	if ($FoundOne) {
-		exit 0 # success
-	}
-	write-error "City $City not found"
-	exit 1
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of locate-city.ps1 as of 08/06/2023 21:36:14)*

Docs/my-profile.md

@@ -1,37 +0,0 @@
-*my-profile.ps1*
-================
-
-my-profile.ps1 
-
-
-Parameters
-----------
-```powershell
-
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Script Content
---------------
-```powershell
-# MY POWERSHELL PROFILE (this profile file defines the look & feel of PowerShell)
-
-# WINDOW TITLE
-if ($IsLinux) { $Username = $(whoami) } else { $Username = $env:USERNAME }
-$host.ui.RawUI.WindowTitle = "$Username @ $(hostname)"
-
-# COMMAND PROMPT
-function prompt { write-host -noNewline -foregroundColor yellow "`n➤"; return " " }
-
-# ALIAS NAMES
-del alias:pwd -force -errorAction SilentlyContinue
-set-alias -name pwd -value list-workdir.ps1	# pwd = print working directory
-set-alias -name ll -value get-childitem		# ll = list folder (long format)
-del alias:ls -force -errorAction SilentlyContinue 
-set-alias -name ls -value list-folder.ps1	# ls = list folder (short format)
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of my-profile.ps1 as of 08/06/2023 21:36:14)*

Docs/new-branch.md

@@ -1,112 +0,0 @@
-*new-branch.ps1*
-================
-
-This PowerShell script creates a new branch in a Git repository and switches to it.
-
-Parameters
-----------
-```powershell
-PS> ./new-branch.ps1 [[-newBranch] <String>] [[-repoPath] <String>] [<CommonParameters>]
-
--newBranch <String>
-    Specifies the new branch name
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--repoPath <String>
-    Specifies the path to the Git repository (current working directory per default)
-    
-    Required?                    false
-    Position?                    2
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./new-branch.ps1 test123
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Creates a new Git branch 
-.DESCRIPTION
-	This PowerShell script creates a new branch in a Git repository and switches to it.
-.PARAMETER newBranch
-	Specifies the new branch name
-.PARAMETER repoPath
-	Specifies the path to the Git repository (current working directory per default)
-.EXAMPLE
-	PS> ./new-branch.ps1 test123
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$newBranch = "", [string]$repoPath = "$PWD")
-
-try {
-	if ($newBranch -eq "") { $newBranch = Read-Host "Enter the new branch name" }
-
-	$stopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	Write-Host "⏳ (1/6) Searching for Git executable...  " -noNewline
-	& git --version
-	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
-
-	Write-Host "⏳ (2/6) Checking local repository...     📂$repoPath"
-	if (-not(Test-Path "$repoPath" -pathType container)) { throw "Can't access directory: $repoPath" }
-	$repoPathName = (Get-Item "$repoPath").Name
-
-	"⏳ (3/6) Fetching latest updates..."
-	& git -C "$repoPath" fetch --all --recurse-submodules --prune --prune-tags --force
-	if ($lastExitCode -ne "0") { throw "'git fetch' failed with exit code $lastExitCode" }
-
-	$currentBranch = (git -C "$repoPath" rev-parse --abbrev-ref HEAD)
-	if ($lastExitCode -ne "0") { throw "'git rev-parse' failed with exit code $lastExitCode" }
-
-	"⏳ (4/6) Creating branch..."
-	& git -C "$repoPath" checkout -b "$newBranch"
-	if ($lastExitCode -ne "0") { throw "'git checkout -b $newBranch' failed with exit code $lastExitCode" }
-
-	"⏳ (5/6) Pushing updates..."
-	& git -C "$repoPath" push origin "$newBranch"
-	if ($lastExitCode -ne "0") { throw "'git push origin $newBranch' failed with exit code $lastExitCode" }
-
-	"⏳ (6/6) Updating submodules..."
-	& git -C "$repoPath" submodule update --init --recursive
-	if ($lastExitCode -ne "0") { throw "'git submodule update' failed with exit code $lastExitCode" }
-
-	[int]$elapsed = $stopWatch.Elapsed.TotalSeconds
-	"✔️ created branch '$newBranch' based on '$currentBranch' in repo 📂$repoPathName in $elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of new-branch.ps1 as of 08/06/2023 21:36:14)*

Docs/on-desktop-login.md

@@ -1,58 +0,0 @@
-*on-desktop-login.ps1*
-================
-
-This PowerShell script executes tasks on every desktop login.
-
-Parameters
-----------
-```powershell
-PS> ./on-desktop-login.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./on-desktop-login.ps1
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Executes tasks on desktop login
-.DESCRIPTION
-	This PowerShell script executes tasks on every desktop login.
-.EXAMPLE
-	PS> ./on-desktop-login.ps1
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	& "$PSScriptRoot/open-dashboards.ps1"
-	& "$PSScriptRoot/list-news.ps1"
-	& "$PSScriptRoot/write-clock.ps1"
-	exit 0 # success
-} catch {
-        "⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-        exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of on-desktop-login.ps1 as of 08/06/2023 21:36:14)*

Docs/open-dashboards.md

@@ -1,74 +0,0 @@
-*open-dashboards.ps1*
-================
-
-This PowerShell script launches the web browser with tabs of 18 dashboard websites.
-
-Parameters
-----------
-```powershell
-PS> ./open-dashboards.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./open-dashboards.ps1
-⏳ (1/2) Loading Data/web-dashboards.csv...
-⏳ (2/2) Launching web browser with tabs of Toggl Track · Google Calendar · CNN News...
-...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Open web dashboards
-.DESCRIPTION
-	This PowerShell script launches the web browser with tabs of 18 dashboard websites.
-.EXAMPLE
-	PS> ./open-dashboards.ps1
-	⏳ (1/2) Loading Data/web-dashboards.csv...
-	⏳ (2/2) Launching web browser with tabs of Toggl Track · Google Calendar · CNN News...
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-try {
-	$stopWatch = [system.diagnostics.stopwatch]::startNew()
-	Write-Host "⏳ (1/2) Loading Data/web-dashboards.csv..."
-	$table = Import-CSV "$PSScriptRoot/../Data/web-dashboards.csv"
-	$numRows = $table.Length
-	Write-Host "⏳ (2/2) Launching web browser with tabs of " -noNewline
-	foreach($row in $table) {
-		Write-Host "$($row.NAME) · " -noNewline
-		& "$PSScriptRoot/open-default-browser.ps1" "$($row.URL)"
-		Start-Sleep -milliseconds 100
-	}
-	Write-Host ""
-	[int]$elapsed = $stopWatch.Elapsed.TotalSeconds
-	"✅ Opened $NumRows web dashboards in $elapsed sec (Hint: use 'switch-tabs.ps1' to switch between the tabs automatically)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of open-dashboards.ps1 as of 08/06/2023 21:36:14)*

Docs/open-notepad.md

@@ -1,26 +0,0 @@
-## open-notepad.ps1 - Starts Notepad
-
-This script launches the Notepad application.
-
-## Parameters
-```powershell
-/home/markus/Repos/PowerShell/Scripts/open-notepad.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./open-notepad
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of open-notepad.ps1*

Docs/play-files.md

@@ -1,79 +0,0 @@
-*play-files.ps1*
-================
-
-This PowerShell script plays the given audio files (supporting MP3 and WAV format).
-
-Parameters
-----------
-```powershell
-PS> ./play-files.ps1 [[-FilePattern] <String>] [<CommonParameters>]
-
--FilePattern <String>
-    Specifies the file pattern
-    
-    Required?                    false
-    Position?                    1
-    Default value                *
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./play-files *.mp3
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Plays audio files (MP3 and WAV)
-.DESCRIPTION
-	This PowerShell script plays the given audio files (supporting MP3 and WAV format).
-.PARAMETER FilePattern
-	Specifies the file pattern
-.EXAMPLE
-	PS> ./play-files *.mp3
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$FilePattern = "*")
-
-try {
-	$Files = (get-childItem -path "$FilePattern" -attributes !Directory)
-	"Playing $($Files.Count) files ..."
-	foreach ($File in $Files) {
-		if ("$File" -like "*.mp3") {
-			& "$PSScriptRoot/play-mp3.ps1" "$File"
-		} elseif ("$File" -like "*.wav") {
-			& "$PSScriptRoot/play-mp3.ps1" "$File"
-		} else {
-			"Skipping $File ..."
-		}
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of play-files.ps1 as of 08/06/2023 21:36:16)*

Docs/play-happy-birthday.md

@@ -1,75 +0,0 @@
-*play-happy-birthday.ps1*
-================
-
-This PowerShell script plays the famous Happy Birthday song.
-
-Parameters
-----------
-```powershell
-PS> ./play-happy-birthday.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./play-happy-birthday
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Plays the Happy Birthday song
-.DESCRIPTION
-	This PowerShell script plays the famous Happy Birthday song.
-.EXAMPLE
-	PS> ./play-happy-birthday
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-[System.Console]::Beep(1059.274, 300)
-[System.Console]::Beep(1059.274, 200)
-[System.Console]::Beep(1188.995, 500)
-[System.Console]::Beep(1059.274, 500)
-[System.Console]::Beep(1413.961, 500)
-[System.Console]::Beep(1334.601, 950)
-[System.Console]::Beep(1059.274, 300)
-[System.Console]::Beep(1059.274, 200)
-[System.Console]::Beep(1188.995, 500)
-[System.Console]::Beep(1059.274, 500)
-[System.Console]::Beep(1587.117, 500)
-[System.Console]::Beep(1413.961, 950)
-[System.Console]::Beep(1059.274, 300)
-[System.Console]::Beep(1059.274, 200)
-[System.Console]::Beep(2118.547, 500)
-[System.Console]::Beep(1781.479, 500)
-[System.Console]::Beep(1413.961, 500)
-[System.Console]::Beep(1334.601, 500)
-[System.Console]::Beep(1188.995, 500)
-[System.Console]::Beep(1887.411, 300)
-[System.Console]::Beep(1887.411, 200)
-[System.Console]::Beep(1781.479, 500)
-[System.Console]::Beep(1413.961, 500)
-[System.Console]::Beep(1587.117, 500)
-[System.Console]::Beep(1413.961, 900)
-exit 0 # success
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of play-happy-birthday.ps1 as of 08/06/2023 21:36:16)*

Docs/play-imperial-march.md

@@ -1,68 +0,0 @@
-*play-imperial-march.ps1*
-================
-
-This PowerShell script plays the Imperial March used in the Star Wars film series.
-
-Parameters
-----------
-```powershell
-PS> ./play-imperial-march.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./play-imperial-march
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Plays the Imperial March (Star Wars)
-.DESCRIPTION
-	This PowerShell script plays the Imperial March used in the Star Wars film series.
-.EXAMPLE
-	PS> ./play-imperial-march
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-[System.Console]::beep(440, 500)      
-[System.Console]::beep(440, 500)
-[System.Console]::beep(440, 500)       
-[System.Console]::beep(349, 350)       
-[System.Console]::beep(523, 150)       
-[System.Console]::beep(440, 500)       
-[System.Console]::beep(349, 350)       
-[System.Console]::beep(523, 150)       
-[System.Console]::beep(440, 1000)
-[System.Console]::beep(659, 500)       
-[System.Console]::beep(659, 500)       
-[System.Console]::beep(659, 500)       
-[System.Console]::beep(698, 350)       
-[System.Console]::beep(523, 150)       
-[System.Console]::beep(415, 500)       
-[System.Console]::beep(349, 350)       
-[System.Console]::beep(523, 150)       
-[System.Console]::beep(440, 1000)
-exit 0 # success
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of play-imperial-march.ps1 as of 08/06/2023 21:36:16)*

Docs/play-jingle-bells.md

@@ -1,196 +0,0 @@
-*play-jingle-bells.ps1*
-================
-
-This PowerShell script plays the famous Jingle Bells song.
-
-Parameters
-----------
-```powershell
-PS> ./play-jingle-bells.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./play-jingle-bells
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-        Plays Jingle Bells
-.DESCRIPTION
-        This PowerShell script plays the famous Jingle Bells song.
-.EXAMPLE
-        PS> ./play-jingle-bells
-.LINK
-        https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-$Notes = New-Object -TypeName psobject -Property @{
-    REST    = 0
-    GbelowC = 196
-    A       = 220
-    Asharp  = 233
-    B       = 247
-    C       = 262
-    Csharp  = 277
-    D       = 294
-    Dsharp  = 311
-    E       = 330
-    F       = 349
-    Fsharp  = 370
-    G       = 392
-    Gsharp  = 415
-    AA      = 440
-    AAsharp = 466
-    BB      = 493
-    CC      = 523
-    CCsharp = 554
-    DD      = 587
-    DDsharp = 622
-    EE      = 659
-    FF      = 698
-    FFsharp = 740
-    GG      = 784
-    GGsharp = 830
-    }
-$Duration = New-Object -TypeName psobject -Property @{
-    WHOLE     = 1600
-    HALF      = 800
-    QUARTER   = 400
-    EIGHTH    = 200
-    SIXTEENTH = 100
-    }
-[System.Console]::Beep($Notes.C, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.C, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.C, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.F, $Duration.QUARTER)
-[System.Console]::Beep($Notes.C, $Duration.HALF   )
-[System.Console]::Beep($Notes.C, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.C, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.C, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.F, $Duration.QUARTER)
-[System.Console]::Beep($Notes.D, $Duration.HALF   )
-Start-Sleep -m $Duration.EIGHTH
-[System.Console]::Beep($Notes.D, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.E, $Duration.QUARTER)
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.E, $Duration.HALF)
-Start-Sleep -m $Duration.EIGHTH
-[System.Console]::Beep($Notes.E, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.HALF)
-[System.Console]::Beep($Notes.C, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.C, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.C, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.F, $Duration.QUARTER)
-[System.Console]::Beep($Notes.C, $Duration.HALF   )
-[System.Console]::Beep($Notes.C, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.C, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.C, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.F, $Duration.QUARTER)
-[System.Console]::Beep($Notes.D, $Duration.HALF   )
-Start-Sleep -m $Duration.QUARTER
-[System.Console]::Beep($Notes.D, $Duration.EIGHTH )
-[System.Console]::Beep($Notes.E, $Duration.QUARTER)
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.DD, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.F, $Duration.HALF)
-[System.Console]::Beep($Notes.CC, $Duration.HALF)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.HALF)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.HALF)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.F, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.AA, $Duration.HALF)
-Start-Sleep -m $Duration.EIGHTH
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.BB, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.AA, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.HALF)
-[System.Console]::Beep($Notes.CC, $Duration.HALF)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.HALF)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.HALF)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.F, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.AA, $Duration.HALF)
-Start-Sleep -m $Duration.EIGHTH
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.QUARTER)
-[System.Console]::Beep($Notes.AA, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.AA, $Duration.EIGHTH)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.CC, $Duration.QUARTER)
-[System.Console]::Beep($Notes.BB, $Duration.QUARTER)
-[System.Console]::Beep($Notes.G, $Duration.QUARTER)
-[System.Console]::Beep($Notes.F, $Duration.HALF)
-exit 0 # success
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of play-jingle-bells.ps1 as of 08/06/2023 21:36:16)*

Docs/play-m3u.md

@@ -1,95 +0,0 @@
-*play-m3u.ps1*
-================
-
-This PowerShell script plays the given playlist (in .M3U file format)
-
-Parameters
-----------
-```powershell
-PS> ./play-m3u.ps1 [[-filename] <String>] [<CommonParameters>]
-
--filename <String>
-    Specifies the path to the playlist
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./play-m3u C:\MyPlaylist.m3u
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Plays a playlist (.M3U format)
-.DESCRIPTION
-	This PowerShell script plays the given playlist (in .M3U file format)
-.PARAMETER filename
-	Specifies the path to the playlist
-.EXAMPLE
-	PS> ./play-m3u C:\MyPlaylist.m3u
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$filename = "")
-
-try {
-	if ($filename -eq "" ) { $filename = read-host "Enter the M3U playlist filename" }
-
-	if (-not(test-path "$filename" -pathType leaf)) { throw "Can't access playlist file: $filename" }
-	$Lines = get-content $filename
-
-	add-type -assemblyName presentationCore
-	$MediaPlayer = new-object system.windows.media.mediaplayer
-
-	for ([int]$i=0; $i -lt $Lines.Count; $i++) {
-		$Line = $Lines[$i]
-		if ($Line[0] -eq "#") { continue }
-		if (-not(test-path "$Line" -pathType leaf)) { throw "Can't access audio file: $Line" }
-		$FullPath = (get-childItem "$Line").fullname
-		$filename = (get-item "$FullPath").name
-		do {
-			$MediaPlayer.open("$FullPath")
-			$Milliseconds = $MediaPlayer.NaturalDuration.TimeSpan.TotalMilliseconds
-		} until ($Milliseconds)
-		[int]$Minutes = $Milliseconds / 60000
-		[int]$Seconds = ($Milliseconds / 1000) % 60
-		"▶️Playing 🎵$filename ($($Minutes.ToString('00')):$($Seconds.ToString('00'))) ..."
-		$MediaPlayer.Volume = 1
-		$MediaPlayer.play()
-		start-sleep -milliseconds $Milliseconds
-		$MediaPlayer.stop()
-		$MediaPlayer.close()
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of play-m3u.ps1 as of 08/06/2023 21:36:16)*

Docs/play-mission-impossible.md

@@ -1,96 +0,0 @@
-*play-mission-impossible.ps1*
-================
-
-This PowerShell script plays the Mission Impossible theme.
-
-Parameters
-----------
-```powershell
-PS> ./play-mission-impossible.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./play-mission-impossible
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Plays the Mission Impossible theme
-.DESCRIPTION
-	This PowerShell script plays the Mission Impossible theme.
-.EXAMPLE
-	PS> ./play-mission-impossible
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-[System.Console]::Beep(784,150)
-Start-Sleep -m 300
-[System.Console]::Beep(784,150)
-Start-Sleep -m 300
-[System.Console]::Beep(932,150)
-Start-Sleep -m 150
-[System.Console]::Beep(1047,150)
-Start-Sleep -m 150
-[System.Console]::Beep(784,150)
-Start-Sleep -m 300
-[System.Console]::Beep(784,150)
-Start-Sleep -m 300
-[console]::Beep(699,150)
-Start-Sleep -m 150
-[System.Console]::Beep(740,150)
-Start-Sleep -m 150
-[System.Console]::Beep(784,150)
-Start-Sleep -m 300
-[System.Console]::Beep(784,150)
-Start-Sleep -m 300
-[System.Console]::Beep(932,150)
-Start-Sleep -m 150
-[System.Console]::Beep(1047,150)
-Start-Sleep -m 150
-[System.Console]::Beep(784,150)
-Start-Sleep -m 300
-[System.Console]::Beep(784,150)
-Start-Sleep -m 300
-[System.Console]::Beep(699,150)
-Start-Sleep -m 150
-[System.Console]::Beep(740,150)
-Start-Sleep -m 150
-[System.Console]::Beep(932,150)
-[System.Console]::Beep(784,150)
-[System.Console]::Beep(587,1200)
-Start-Sleep -m 75
-[System.Console]::Beep(932,150)
-[System.Console]::Beep(784,150)
-[System.Console]::Beep(554,1200)
-Start-Sleep -m 75
-[System.Console]::Beep(932,150)
-[System.Console]::Beep(784,150)
-[System.Console]::Beep(523,1200)
-Start-Sleep -m 150
-[System.Console]::Beep(466,150)
-[System.Console]::Beep(523,150)
-exit 0 # success
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of play-mission-impossible.ps1 as of 08/06/2023 21:36:16)*

Docs/play-mp3.md

@@ -1,94 +0,0 @@
-*play-mp3.ps1*
-================
-
-This PowerShell script plays a sound file in .MP3 file format.
-
-Parameters
-----------
-```powershell
-PS> ./play-mp3.ps1 [[-Path] <String>] [<CommonParameters>]
-
--Path <String>
-    Specifies the path to the .MP3 file
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./play-mp3 C:\thunder.mp3
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Plays a MP3 sound file 
-.DESCRIPTION
-	This PowerShell script plays a sound file in .MP3 file format.
-.PARAMETER Path
-	Specifies the path to the .MP3 file
-.EXAMPLE
-	PS> ./play-mp3 C:\thunder.mp3
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$Path = "")
-
-try {
-	if ($Path -eq "" ) { $Path = Read-Host "Enter the path to the MP3 sound file" }
-
-	if (-not(Test-Path "$Path" -pathType leaf)) { throw "Can't access sound file: $Path" }
-	$FullPath = (Get-ChildItem $Path).fullname
-	$Filename = (Get-Item "$FullPath").name
-
-	Add-Type -assemblyName PresentationCore
-	$MediaPlayer = New-Object System.Windows.Media.MediaPlayer
-
-	do {
-		$MediaPlayer.open($FullPath)
-		$Milliseconds = $MediaPlayer.NaturalDuration.TimeSpan.TotalMilliseconds
-	} until ($Milliseconds)
-
-	[int]$Minutes = $Milliseconds / 60000
-	[int]$Seconds = ($Milliseconds / 1000) % 60
-	"▶️ Playing $Filename for $($Minutes.ToString('00')):$($Seconds.ToString('00')) sec..."
-	$PreviousTitle = $host.ui.RawUI.WindowTitle 
-	$host.ui.RawUI.WindowTitle = "▶️ $Filename"
-	$MediaPlayer.Volume = 1
-	$MediaPlayer.play()
-	Start-Sleep -milliseconds $Milliseconds
-	$MediaPlayer.stop()
-	$MediaPlayer.close()
-	$host.ui.RawUI.WindowTitle = $PreviousTitle
-
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of play-mp3.ps1 as of 08/06/2023 21:36:16)*

Docs/play-radio-absolute-chillout.md

@@ -1,26 +0,0 @@
-## play-radio-absolute-chillout.ps1 - Plays radio station Absolute Chillout
-
-This script launches the Web browser and plays radio station Absolute Chillout.
-
-## Parameters
-```powershell
-play-radio-absolute-chillout.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-absolute-chillout
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-absolute-chillout.ps1*

Docs/play-radio-afn-stuttgart.md

@@ -1,26 +0,0 @@
-## play-radio-afn-stuttgart.ps1 - Plays radio AFN Stuttgart
-
-This script launches the Web browser and plays radio station AFN Stuttgart.
-
-## Parameters
-```powershell
-play-radio-afn-stuttgart.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-afn-stuttgart
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-afn-stuttgart.ps1*

Docs/play-radio-arabella.md

@@ -1,26 +0,0 @@
-## play-radio-arabella.ps1 - Plays radio station Arabella
-
-This script launches the Web browser and plays radio station Arabella.
-
-## Parameters
-```powershell
-play-radio-arabella.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-arabella
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-arabella.ps1*

Docs/play-radio-blue.md

@@ -1,26 +0,0 @@
-## play-radio-blue.ps1 - Plays Radio Blue 100.7
-
-This script launches the Web browser and plays radio station Blue 100.7.
-
-## Parameters
-```powershell
-play-radio-blue.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-blue
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-blue.ps1*

Docs/play-radio-bob.md

@@ -1,26 +0,0 @@
-## play-radio-bob.ps1 - Plays radio station BOB!
-
-This script launches the Web browser and plays radio station BOB!
-
-## Parameters
-```powershell
-play-radio-bob.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-bob
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-bob.ps1*

Docs/play-radio-club-mix.md

@@ -1,26 +0,0 @@
-## play-radio-club-mix.ps1 - Plays radio station CLUBMIX
-
-This script launches the Web browser and plays radio station CLUBMIX.
-
-## Parameters
-```powershell
-play-radio-club-mix.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-club-mix
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-club-mix.ps1*

Docs/play-radio-costa-del-mar.md

@@ -1,26 +0,0 @@
-## play-radio-costa-del-mar.ps1 - Plays the radio station Costa Del Mar
-
-This script launches the Web browser and plays radio station Costa Del Mar.
-
-## Parameters
-```powershell
-play-radio-costa-del-mar.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-costa-del-mar
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-costa-del-mar.ps1*

Docs/play-radio-dance-fm.md

@@ -1,26 +0,0 @@
-## play-radio-dance-fm.ps1 - Plays radio station Dance FM
-
-This script launches the Web browser and plays radio station Dance FM.
-
-## Parameters
-```powershell
-play-radio-dance-fm.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-dance-fm
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-dance-fm.ps1*

Docs/play-radio-enjoy.md

@@ -1,26 +0,0 @@
-## play-radio-enjoy.ps1 - Plays radio station N-JOY
-
-This script launches the Web browser and plays radio station N-JOY.
-
-## Parameters
-```powershell
-play-radio-enjoy.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-enjoy
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-enjoy.ps1*

Docs/play-radio-ffn.md

@@ -1,26 +0,0 @@
-## play-radio-ffn.ps1 - Plays radio station FFN
-
-This script launches the Web browser and plays radio station FFN.
-
-## Parameters
-```powershell
-play-radio-ffn.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-ffn
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-ffn.ps1*

Docs/play-radio-galaxy.md

@@ -1,26 +0,0 @@
-## play-radio-galaxy.ps1 - Plays radio station Galaxy
-
-This script launches the Web browser and plays radio station Galaxy.
-
-## Parameters
-```powershell
-play-radio-galaxy.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-galaxy
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-galaxy.ps1*

Docs/play-radio-gong.md

@@ -1,26 +0,0 @@
-## play-radio-gong.ps1 - Plays radio station Gong
-
-This script launches the Web browser and plays radio station Gong.
-
-## Parameters
-```powershell
-play-radio-gong.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-gong
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-gong.ps1*

Docs/play-radio-ibiza.md

@@ -1,26 +0,0 @@
-## play-radio-ibiza.ps1 - Plays radio station Ibiza
-
-This script launches the Web browser and plays radio station Ibiza.
-
-## Parameters
-```powershell
-play-radio-ibiza.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-ibiza
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-ibiza.ps1*

Docs/play-radio-jam-fm.md

@@ -1,26 +0,0 @@
-## play-radio-jam-fm.ps1 - Plays radio station JAM FM
-
-This script launches the Web browser and plays the radio station JAM FM.
-
-## Parameters
-```powershell
-play-radio-jam-fm.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-jam-fm
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-jam-fm.ps1*

Docs/play-radio-kiss-kiss.md

@@ -1,26 +0,0 @@
-## play-radio-kiss-kiss.ps1 - Plays radio station Kiss Kiss
-
-This script launches the Web browser and plays radio station Kiss Kiss.
-
-## Parameters
-```powershell
-play-radio-kiss-kiss.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-kiss-kiss
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-kiss-kiss.ps1*

Docs/play-radio-malibu.md

@@ -1,26 +0,0 @@
-## play-radio-malibu.ps1 - Plays radio station Malibu
-
-This script launches the Web browser and plays radio station Malibu.
-
-## Parameters
-```powershell
-play-radio-malibu.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-malibu
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-malibu.ps1*

Docs/play-radio-n-joy.md

@@ -1,26 +0,0 @@
-## play-radio-n-joy.ps1 - Plays radio station N-JOY
-
-This script launches the Web browser and plays radio station N-JOY.
-
-## Parameters
-```powershell
-/home/markus/Repos/PowerShell/Scripts/play-radio-n-joy.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-n-joy
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-n-joy.ps1*

Docs/play-radio-paloma.md

@@ -1,26 +0,0 @@
-## play-radio-paloma.ps1 - Plays radio station Paloma
-
-This script launches the Web browser and plays radio station Paloma.
-
-## Parameters
-```powershell
-play-radio-paloma.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-paloma
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-paloma.ps1*

Docs/play-radio-seven.md

@@ -1,26 +0,0 @@
-## play-radio-seven.ps1 - Plays Radio 7 Ulm
-
-This script launches the Web browser and plays radio station 7 Ulm.
-
-## Parameters
-```powershell
-play-radio-seven.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-seven
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-seven.ps1*

Docs/play-radio-you-fm.md

@@ -1,26 +0,0 @@
-## play-radio-you-fm.ps1 - Plays radio station YOU FM
-
-This script launches the Web browser and plays radio station YOU FM.
-
-## Parameters
-```powershell
-play-radio-you-fm.ps1 [<CommonParameters>]
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-## Example
-```powershell
-PS> ./play-radio-you-fm
-
-```
-
-## Notes
-Author: Markus Fleschutz · License: CC0
-
-## Related Links
-https://github.com/fleschutz/PowerShell
-
-*Generated by convert-ps2md.ps1 using the comment-based help of play-radio-you-fm.ps1*

Docs/pull-repo.md

@@ -1,90 +0,0 @@
-*pull-repo.ps1*
-================
-
-This PowerShell script pulls the latest updates into a local Git repository (including submodules).
-
-Parameters
-----------
-```powershell
-PS> ./pull-repo.ps1 [[-RepoDir] <String>] [<CommonParameters>]
-
--RepoDir <String>
-    Specifies the file path to the local Git repository (default is working directory)
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./pull-repo C:\MyRepo
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Pulls repository updates 
-.DESCRIPTION
-	This PowerShell script pulls the latest updates into a local Git repository (including submodules).
-.PARAMETER RepoDir
-	Specifies the file path to the local Git repository (default is working directory)
-.EXAMPLE
-	PS> ./pull-repo C:\MyRepo
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$RepoDir = "$PWD")
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	Write-Host "⏳ (1/4) Searching for Git executable...  " -noNewline
-	& git --version
-	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
-
-	Write-Host "⏳ (2/4) Checking local repository...     📂$RepoDir"
-	if (-not(Test-Path "$RepoDir" -pathType container)) { throw "Can't access folder: $RepoDir" }
-	$Result = (git -C "$RepoDir" status)
-	if ("$Result" -match "HEAD detached at ") { throw "Currently in detached HEAD state (not on a branch!), so nothing to pull" }
-	$RepoDirName = (Get-Item "$RepoDir").Name
-
-	Write-Host "⏳ (3/4) Pulling updates..."
-	& git -C "$RepoDir" pull --recurse-submodules=yes
-	if ($lastExitCode -ne "0") { throw "'git pull' failed with exit code $lastExitCode" }
-
-	Write-Host "⏳ (4/4) Updating submodules... "
-	& git -C "$RepoDir" submodule update --init --recursive
-	if ($lastExitCode -ne "0") { throw "'git submodule update' failed with exit code $lastExitCode" }
-
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ Pulling updates into repository 📂$RepoDirName took $Elapsed sec"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of pull-repo.ps1 as of 08/06/2023 21:36:16)*

Docs/pull-repos.md

@@ -1,104 +0,0 @@
-*pull-repos.ps1*
-================
-
-This PowerShell script pulls updates into all Git repositories in a folder (including submodules).
-
-Parameters
-----------
-```powershell
-PS> ./pull-repos.ps1 [[-ParentDir] <String>] [<CommonParameters>]
-
--ParentDir <String>
-    Specifies the path to the parent folder
-    
-    Required?                    false
-    Position?                    1
-    Default value                "$PWD"
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./pull-repos C:\MyRepos
-⏳ (1) Searching for Git executable...  git version 2.41.0.windows.3
-⏳ (2) Checking parent folder...        33 subfolders
-⏳ (3/35) Pulling into 📂base256unicode...
-...
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Pulls updates into Git repos
-.DESCRIPTION
-	This PowerShell script pulls updates into all Git repositories in a folder (including submodules).
-.PARAMETER ParentDir
-	Specifies the path to the parent folder
-.EXAMPLE
-	PS> ./pull-repos C:\MyRepos
-	⏳ (1) Searching for Git executable...  git version 2.41.0.windows.3
-	⏳ (2) Checking parent folder...        33 subfolders
-	⏳ (3/35) Pulling into 📂base256unicode...
-	...
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$ParentDir = "$PWD")
-
-try {
-	$StopWatch = [system.diagnostics.stopwatch]::startNew()
-
-	Write-Host "⏳ (1) Searching for Git executable...     " -NoNewline
-	& git --version
-	if ($lastExitCode -ne "0") { throw "Can't execute 'git' - make sure Git is installed and available" }
-
-	Write-Host "⏳ (2) Checking parent folder...           " -NoNewline
-	if (-not(Test-Path "$ParentDir" -pathType container)) { throw "Can't access folder: $ParentDir" }
-	$Folders = (Get-ChildItem "$ParentDir" -attributes Directory)
-	$NumFolders = $Folders.Count
-	$ParentDirName = (Get-Item "$ParentDir").Name
-	Write-Host "$NumFolders subfolders"
-
-	[int]$Step = 3
-	[int]$Failed = 0
-	foreach ($Folder in $Folders) {
-		$FolderName = (Get-Item "$Folder").Name
-		Write-Host "⏳ ($Step/$($NumFolders + 2)) Pulling into 📂$FolderName...    " -NoNewline
-
-		& git -C "$Folder" pull --recurse-submodules --jobs=4
-		if ($lastExitCode -ne "0") { $Failed++; write-warning "'git pull' in 📂$FolderName failed" }
-
-		& git -C "$Folder" submodule update --init --recursive
-		if ($lastExitCode -ne "0") { throw "'git submodule update' in 📂$Folder failed with exit code $lastExitCode" }
-		$Step++
-	}
-	[int]$Elapsed = $StopWatch.Elapsed.TotalSeconds
-	"✔️ Pulling updates into $NumFolders repositories under 📂$ParentDirName took $Elapsed sec ($Failed failed)"
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of pull-repos.ps1 as of 08/06/2023 21:36:16)*

Docs/search-files.md

@@ -1,95 +0,0 @@
-*search-files.ps1*
-================
-
-This PowerShell script searches for a pattern in the given files.
-
-Parameters
-----------
-```powershell
-PS> ./search-files.ps1 [[-pattern] <String>] [[-files] <String>] [<CommonParameters>]
-
--pattern <String>
-    Specifies the search pattern
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
--files <String>
-    Specifies the files
-    
-    Required?                    false
-    Position?                    2
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./search-files UFO C:\Temp\*.txt
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Searches for a pattern in files
-.DESCRIPTION
-	This PowerShell script searches for a pattern in the given files.
-.PARAMETER pattern
-	Specifies the search pattern
-.PARAMETER files
-	Specifies the files
-.EXAMPLE
-	PS> ./search-files UFO C:\Temp\*.txt
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$pattern = "", [string]$files = "")
-
-function ListLocations { param([string]$Pattern, [string]$Path)
-	$List = Select-String -Path $Path -Pattern "$Pattern" 
-	foreach ($Item in $List) {
-		New-Object PSObject -Property @{
-			'Path' = "$($Item.Path)"
-			'Line' = "$($Item.LineNumber)"
-			'Text' = "$($Item.Line)"
-		}
-	}
-	write-output "(found $($List.Count) locations with pattern '$pattern')"
-}
-
-try {
-	if ($pattern -eq "" ) { $pattern = read-host "Enter search pattern" }
-	if ($files -eq "" ) { $files = read-host "Enter path to files" }
-
-	ListLocations $pattern $files | format-table -property Path,Line,Text
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of search-files.ps1 as of 08/06/2023 21:36:16)*

Docs/speak-checklist.md

@@ -1,81 +0,0 @@
-*speak-checklist.ps1*
-================
-
-This PowerShell script speaks the given checklist by text-to-speech (TTS).
-
-Parameters
-----------
-```powershell
-PS> ./speak-checklist.ps1 [[-Name] <String>] [<CommonParameters>]
-
--Name <String>
-    Specifies the name of the checklist
-    
-    Required?                    false
-    Position?                    1
-    Default value                
-    Accept pipeline input?       false
-    Accept wildcard characters?  false
-
-[<CommonParameters>]
-    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
-    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
-```
-
-Example
--------
-```powershell
-PS> ./speak-checklist.ps1
-
-```
-
-Notes
------
-Author: Markus Fleschutz | License: CC0
-
-Related Links
--------------
-https://github.com/fleschutz/PowerShell
-
-Script Content
---------------
-```powershell
-<#
-.SYNOPSIS
-	Speaks a checklist by text-to-speech
-.DESCRIPTION
-	This PowerShell script speaks the given checklist by text-to-speech (TTS).
-.PARAMETER Name
-	Specifies the name of the checklist
-.EXAMPLE
-	PS> ./speak-checklist.ps1
-.LINK
-	https://github.com/fleschutz/PowerShell
-.NOTES
-	Author: Markus Fleschutz | License: CC0
-#>
-
-param([string]$Name = "")
-
-try {
-	if ($Name -eq "") { $Name = Read-Host "Enter the name of the checklist" }
-
-	$Lines = Get-Content -path "$PSScriptRoot/../Data/Checklists/$Name.txt"
-	clear-host
-	$Step = 1
-	foreach($Line in $Lines) {
-		if ($Line -like "HEAD*") { & "$PSScriptRoot/write-big.ps1" "$($Line.substring(5))"; continue }
-
-		""			
-		& "$PSScriptRoot/speak-english.ps1" "$($Step). $Line"
-		$Dummy = Read-Host "    Say <Check> or press <Return> to continue"
-		$Step++
-	}
-	exit 0 # success
-} catch {
-	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
-	exit 1
-}
-```
-
-*(generated by convert-ps2md.ps1 using the comment-based help of speak-checklist.ps1 as of 08/06/2023 21:36:17)*