MQuicker

Helping people access webcomics in a way that is intuitive, enjoyable, and efficient

Welcome to the MQuicker Website

The first priority of this website is to enable copying of Powershell/Terminal text into its appropriate program for the MQuicker install. If you would like more details on the aim of this project and its implementation, please see here. When pasting text into Windows Powershell, use the right click. Scroll down to the section that best describes your situation and copy & paste the steps into your Powershell/Terminal.

For the Two-Step Installs, run the first step, close terminal, and then run the second step.

To join our Discord community, use this link. Anyone there will happily help you with installation or discuss manga with you.

Choose Show All to see it work and Primer to customize for yourself on first use.

Windows        Mac Regular        Mac for Python Users

Some Good to Know Items Below
Important for Windows

Finding the launch.ps1 file within C:\MQuicker\WindowsSetUp and running it in Powershell will open MQuicker. Also, a shortcut to this program called "MQuicker - For Desktop" should appear on your Desktop (specifically C:\Users\YOURNAME(\OneDrive)\Desktop). Setting PowerShell as the default program to open .ps1 by right clicking the icon, selecting Open With -> Choose Another App -> Always Use this App to Open .ps1 Files -> More Apps -> Look for an App on Your PC and then find and choose powershell.exe (the .exe usually is not shown) to easily access MQuicker from the Desktop. Following this, opening the shortcut will run the program. (I found Powershell in C:\Windows\System32\WindowsPowerShell\v1.0) Alternatively, right click the shortcut and select "Run with Powershell"

Important for Mac

The program looks best in dark mode and if you are not a regular Terminal user, it makes sense to associate opening Terminal with starting MQuicker. You can do both by clicking Preferences in the top left of your screen or simply pressing Cmd+, within Terminal. This guide explains the process. I recommend following the steps in the first section, "Tweaking Terminal's Theme," and choosing Pro before running the second step. The second section, "Login Commands," should run the command sh launch.sh if you intend to use this feature. Only set this after installation is completed.

Windows Two-Step



cd c:\
$url = 'https://github.com/JacobK233811/MQuicker/archive/MQuicker-minimal.zip'
New-Item -ItemType Directory Zips
$Dest = 'C:\Zips\MQ.zip'
$web = New-Object -TypeName System.Net.WebClient
$web.DownloadFile($url, $Dest)
# New-Item -ItemType Directory Extracts
$ExtractDir = 'C:\'
$ExtShell = New-Object -ComObject Shell.Application
$file = $ExtShell.Namespace($Dest).Items()
$ExtShell.Namespace($ExtractDir).CopyHere($file)
# cd MQuicker
Rename-Item -Path .\MQuicker-MQuicker-minimal .\MQuicker
rm -r Zips
cd MQuicker
# Credits to deto's Miniconda-Install GitHub repository
$ErrorActionPreference = "Stop"
# Name of application to install
$AppName="Python, Pip, & Conda"
# Set your project's install directory name here
$InstallDir="PythonFiles"
# Dependencies installed with pip instead
# Comment out the next line if no PyPi dependencies
$PyPiPackage="-r requirements.txt"
Write-Host -Foreground Green ("`nInstalling $AppName to "+(get-location).path+"\$InstallDir")
rm "PythonFiles\.gitkeep" # Download Latest Miniconda Installer
Write-Host -Foreground Green "`nDownloading Miniconda Installer...`n"
(New-Object System.Net.WebClient).DownloadFile("https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe", "$pwd\Miniconda_Install.exe")
# Install Python environment through Miniconda
Write-Host "Installing Miniconda...`n"
Start-Process Miniconda_Install.exe "/S /AddToPath=1 /D=$pwd\$InstallDir" -Wait
# Cleanup
Remove-Item "Miniconda_Install.exe"
Write-Host -Foreground Green ("Close this shell, open a new one, and run the contents of setup2.ps1")
# End Step 1


Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
cd c:\MQuicker\WindowsSetUp
pip install virtualenv==20.0.31
virtualenv mq
.\mq\Scripts\activate
Write-Host -Foreground Green ("`Please exercise patience as the following packages install.")
pip install -r "..\requirements.txt"
Invoke-Expression "ls $env:USERPROFILE\OneDrive\Desktop" -ErrorVariable isnotonedrive
if (!isnotonedrive) {mv ".\MQuicker - For Desktop.lnk" ($env:USERPROFILE + "\OneDrive\Desktop")} else {mv ".\MQuicker - For Desktop.lnk" ($env:USERPROFILE + "\Desktop")}
mv ".\MQuicker - For Desktop.lnk" ($env:USERPROFILE + "\Desktop")
Write-Host ("`nCongratulations on Setting Up MQuicker!!")
cd ..
python checker.py
# End Step 2

Mac Two-Step




setopt interactivecomments

# (not neccessary on bash shell)

cd $HOME
url='https://github.com/JacobK233811/MQuicker/archive/MQuicker-minimal.zip'
mkdir Zips
Dest=$HOME/Zips/MQ.zip
curl $url -L -o $Dest
# mkdir Extracts
ExtractDir=$HOME
cd Zips
unzip -q MQ.zip -d $ExtractDir
# cd $ExtractDir
cd ..
rm -r Zips
mv "./MQuicker-MQuicker-minimal" './MQuicker'
cd MQuicker
# Credits to detos Miniconda-Install GitHub repository
set -e
# Name of application to install
AppName="Python, Pip, & Conda"
# Set your projects install directory name here
InstallDir="PythonFiles"
# Install the package from PyPi
# Comment out next line if installing locally
PyPiPackage="-r requirements.txt"
echo
echo "Installing $AppName"
echo
echo "Installing into: $(pwd)/$InstallDir"
echo
# Miniconda doesnt work for directory structures with spaces
if [[ $(pwd) == *" "* ]]
then
    echo "ERROR: Cannot install into a directory with a space in its path" >&2
    echo "Exiting..."
    echo
    exit 1
fi
rm "PythonFiles/.gitkeep"
# Test if new directory is empty. Exit if its not
if [ -d $(pwd)/$InstallDir ]; then
    if [ "$(ls -A $(pwd)/$InstallDir)" ]; then
        echo "ERROR: Directory is not empty" >&2
        echo "If you want to install into $(pwd)/$InstallDir, "
        echo "clear the directory first and run this script again."
        echo "Exiting..."
        echo
        exit 1
    fi
fi
# Download and install Miniconda
set +e
curl "https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh" -o Miniconda_Install.sh
if [ $? -ne 0 ]; then
    curl "https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh" -o Miniconda_Install.sh
fi
set -e
bash Miniconda_Install.sh -b -f -p $InstallDir
# Cleanup
rm Miniconda_Install.sh
source "./PythonFiles/bin/activate"
conda init zsh
echo "Close this shell, open a new one, and run the contents of setup2.sh"
# End Step 1


cd $HOME/MQuicker
source "./PythonFiles/bin/activate"
cd MacSetUp
pip3 install virtualenv==20.0.31
virtualenv mq
source "./mq/bin/activate"
python3 -m pip install -U pip
python3 -m pip install -U setuptools
echo -e "\033[1;33mPlease exercise patience as the following packages install.\033[0,0m"
python3 -m pip install -r "../requirements.txt"
mv "./launch.sh" $HOME
echo "Congratulations on Setting Up MQuicker!!"
cd ..
python3 checker.py
# End Step 2

Mac One-Step (Python users only)



cd $HOME
url='https://github.com/JacobK233811/MQuicker/archive/MQuicker-minimal.zip'
mkdir Zips
Dest=$HOME/Zips/MQ.zip
curl $url -L -o $Dest
ExtractDir=$HOME
cd Zips
unzip -q MQ.zip -d $ExtractDir
cd ..
rm -r Zips
mv "./MQuicker-MQuicker-minimal" './MQuicker'
cd MQuicker
cd $HOME/MQuicker/MacSetUp
pip3 install virtualenv==20.0.31
virtualenv mq
source "./mq/bin/activate"
python3 -m pip install -U pip
python3 -m pip install -U setuptools
echo -e "\033[1;33mPlease exercise patience as the following packages install.\033[0,0m"
python3 -m pip install -r "../requirements.txt"
mv "./launch.sh" $HOME
echo "Congratulations on Setting Up MQuicker!!"
cd ..
python3 checker.py
# End Step 1