diff --git a/README.md b/README.md index 68cbb87..d976350 100644 --- a/README.md +++ b/README.md @@ -7,28 +7,31 @@ An image conversion tool for Mac OSX, Windows and Linux. Take modern image form The fastest way to get started is to go here [https://apple2.gs/buckshot](https://apple2.gs/buckshot) where you can download the latest builds for Mac OSX, Windows and Linux. ### Mac OSX -Download and open the DMG file. Drag buckshot into your applications and launch it from there. +Download and open the DMG file. Drag buckshot into your applications and launch it from there. +NOTE! Recent MacOS versions require you to open the "Applications" folder in Finder and right-click -> Choose "Open", as a ~~gatekeeping~~ security precaution.) ### Windows -Download and unzip to the folder where you want it installed. Simply run the buckshot.exe from there. +Download and unzip to the folder where you want it installed. Simply run the buckshot.exe from there. +Note: Windows may warn and require you to "run anyway". ### Linux (Debian) -Download and untar, then run the buckshot.sh script. If you have problems see the README.LINUX file. +Download and unzip and run `AppRun`. If you have problems see the README file. # Usage -Once you start the program, just "Open Source Image", select the "Apple ][ Display Mode" you want to convert your image to, and click "Preview", or even better, click the "Live Preview" checkbox to get real-time feedback on your conversion settings. Once you are satisfied with your conversion settings, click "Save Image File" to save in one of the Apple ][ image formats based on the display mode. If you want to save that image file directly to a ProDOS volume, that is now supported via the "Save To ProDOS" function! Then you can load it up in your favorit emulator, or transfer it to real disks/flash storage to view on glorious vintage hardware. +Once you start the program, just "Open Source Image", select the "Apple ][ Display Mode" you want to convert your image to, and click "Preview", or even better, click the "Live Preview" checkbox to get real-time feedback on your conversion settings. Once you are satisfied with your conversion settings, click "Save Image File" to save in one of the Apple ][ image formats based on the display mode. If you want to save that image file directly to a ProDOS volume, that is now supported via the "Save To ProDOS" function! Then you can load it up in your favorite emulator, or transfer it to real disks/flash storage to view on glorious vintage hardware. # Build -This project is written in C++ using the Qt framework. It calls out to two external binaries for image conversion ([http://www.appleoldies.ca/bmp2dhr/](b2d)) and ProDOS volume support ([http://www.brutaldeluxe.fr/products/crossdevtools/cadius/](CADIUS)). +This project is written in C++ using the Qt framework. It calls out to two external binaries for image conversion ([b2d](http://www.appleoldies.ca/bmp2dhr/)) and ProDOS volume support ([CADIUS](http://www.brutaldeluxe.fr/products/crossdevtools/cadius/)). -You can build and run the project without it, but it won't be able to generate previews or save to ProDOS volumes without those 3rd-party binaries. The authors of those projects are not involved with this project, but have graciously encouraged my integration attempts with this software. +You can build and run the project without those them, but it won't be able to generate previews or save to ProDOS volumes without those two 3rd-party binaries. The authors of those projects are not involved with this project, but have graciously encouraged my integration attempts with this software. -sudo apt-get update -sudo apt-get install build-essential -sudo apt-get install qt5 +I maintain public builds of both utilities for all supported operating systems available here: -You will need to copy the binaries of those two programs for your platform to the build directory you are running. +- https://github.com/digarok/cadius/releases/ +- https://github.com/digarok/b2d/releases/ + +You will need to copy the binaries of those two programs for your platform into the build directory you are running. Example for Mac OSX "Release" build: ``` @@ -37,7 +40,7 @@ cp ../Cadius build-buckshot-Desktop_Qt_5_7_0_clang_64bit-Release/buckshot.app/Co ``` In this example I obviously have the files stored in a parent directory outside of the project folder. -If you can't find/build those binaries for your platform, I suggest you just pull them out of the downloads available at [https://apple2.gs/buckshot](https://apple2.gs/buckshot). +The binaries for those can also just be pulled out of existing downloads available on the [release page](https://github.com/digarok/buckshot/releases/). # Disclaimer This was largely built as a proof-of-concept, and I tried to put it together quite quickly (the original version was over the course of about a week or two.) I would never suggest that this is ididiomatic C++ code or Qt code. I am very results oriented and wrote a lot of this quite procedurally, as I went along adding all my planned features. Please feel free to fork it and make fixes, clean it up, add in other converters, etc. I probably won't have much time to tinker with this one from here on out, as I have most of the features I need for my own usage at this point. diff --git a/doc/web/Screenshot.png b/doc/web/Screenshot.png index 503be30..57d3169 100644 Binary files a/doc/web/Screenshot.png and b/doc/web/Screenshot.png differ