Cart Builder - Revision history

Filmote: /* Saving and Restoring a Cart */

2024-07-01T10:18:30Z

Saving and Restoring a Cart

← Older revision		Revision as of 10:18, 1 July 2024
Line 150:		Line 150:
	The Cart Builder allows the user to save and restore a custom cart using the <code>Download CSV</code> and <code>Upload CSV</code> options, respectively.		The Cart Builder allows the user to save and restore a custom cart using the <code>Download CSV</code> and <code>Upload CSV</code> options, respectively.

	The		The downloaded CSV file will be stored locally on the users machine in a CSV format compliant with the [[Flashcart Format\|Flashcard Format]] used by Mr.Blinky's Python utilities and other tools.

			The Cart Buildersite will retain any games uploaded and custom category headings within its temporary file system. However this is not guaranteed as (eventually) the filesystem on the hosted website may fill and need purging. This will be done and an FIFO basis as it will be assumed that the oldest items are least likely to be recalled.


	~~Flashcart_Format~~

Filmote: /* Saving and Restoring a Cart */

2024-07-01T10:12:12Z

Saving and Restoring a Cart

← Older revision		Revision as of 10:12, 1 July 2024
Line 147:		Line 147:

	== Saving and Restoring a Cart ==		== Saving and Restoring a Cart ==
	The Cart Builder allows the user to save and restore a custom cart using the ~~Dowload~~ CSV and Upload CSV options, respectively.		[[File:CartBuilder SaveRestoreCSV.png\|thumb]]
			The Cart Builder allows the user to save and restore a custom cart using the <code>Download CSV</code> and <code>Upload CSV</code> options, respectively.

			The


	~~[[File:CartBuilder SaveRestoreCSV.png\|thumb]]~~


	Flashcart_Format		Flashcart_Format

Filmote: /* Category Maintenance */

2024-07-01T10:11:35Z

Category Maintenance

← Older revision		Revision as of 10:11, 1 July 2024
Line 5:		Line 5:

	Due to the different wiring of the Arduboy FX and Mini [[What is the Arduboy#Arduboy Variants\|variants]], there are a number of different URLs that specify the Arduboy variant and the initial cart configuration. These URLs are enumerated below:		Due to the different wiring of the Arduboy FX and Mini [[What is the Arduboy#Arduboy Variants\|variants]], there are a number of different URLs that specify the Arduboy variant and the initial cart configuration. These URLs are enumerated below:


	=== Arduboy FX ===		=== Arduboy FX ===
Line 16:		Line 15:

	* [https://www.bloggingadeadhorse.com/cart/Cart.html?&file=arduboy-mini.csv&list=arduboy-mini.csv\|The Full Enchilada] This cart contains all the games that have been published for the Arduboy Mini. This is also appropriate for any device that uses the PE2/HWB pin for CS on the flash chip.		* [https://www.bloggingadeadhorse.com/cart/Cart.html?&file=arduboy-mini.csv&list=arduboy-mini.csv\|The Full Enchilada] This cart contains all the games that have been published for the Arduboy Mini. This is also appropriate for any device that uses the PE2/HWB pin for CS on the flash chip.



	== Flashing a Cart to an Arduboy ==		== Flashing a Cart to an Arduboy ==
Line 35:		Line 32:
	# once the cart has been finalised, click 'Upload' on the presented dialogue. At this point, Chrome will enumerate the USB ports of the device and present a dialogue showing these connections. Select the USB port that the Arduboy is connected to and click 'Connect'		# once the cart has been finalised, click 'Upload' on the presented dialogue. At this point, Chrome will enumerate the USB ports of the device and present a dialogue showing these connections. Select the USB port that the Arduboy is connected to and click 'Connect'
	# the cart will be flashed to the Arduboy. Depending on size, this can take a few minutes.		# the cart will be flashed to the Arduboy. Depending on size, this can take a few minutes.


	=== Flashing a Cart using the Arduboy Toolset ===		=== Flashing a Cart using the Arduboy Toolset ===
Line 50:		Line 46:
	# the Arduboy Toolset should indicate that it has detected your Arduboy. If not, turn the device off and back on again so that id at the Arduboy bootloader screen.		# the Arduboy Toolset should indicate that it has detected your Arduboy. If not, turn the device off and back on again so that id at the Arduboy bootloader screen.
	# click the 'Open File' button and select the newly created <code>.bin</code> file then click 'Upload' to flash the cart image to the Arduboy device.		# click the 'Open File' button and select the newly created <code>.bin</code> file then click 'Upload' to flash the cart image to the Arduboy device.


	=== Flashing a Cart using the Python Scripts ===		=== Flashing a Cart using the Python Scripts ===
Line 66:		Line 61:
	# install Pillow For Windows, run <code>python -m pip install pillow</code> from command line. For OSX, run <code>easy_install pillow</code> from a terminal window.		# install Pillow For Windows, run <code>python -m pip install pillow</code> from command line. For OSX, run <code>easy_install pillow</code> from a terminal window.
	# download Mr.Blinky's Python Utilities from the GitHub repository [https://github.com/MrBlinky/Arduboy-Python-Utilities/archive/refs/heads/master.zip here]. This is a zip file and can be expanded into a convenient directory.		# download Mr.Blinky's Python Utilities from the GitHub repository [https://github.com/MrBlinky/Arduboy-Python-Utilities/archive/refs/heads/master.zip here]. This is a zip file and can be expanded into a convenient directory.


	==== Process ====		==== Process ====
Line 74:		Line 68:
	# the website will generate a cart for you based on the selections you have made and download it as a <code>.bin</code> file into your downloads directory. This may take up to a few minutes depending on the number of games included in the cart.		# the website will generate a cart for you based on the selections you have made and download it as a <code>.bin</code> file into your downloads directory. This may take up to a few minutes depending on the number of games included in the cart.
	# open a command window and navigate to the directory where the Python Utilities were expanded to. Run the command <code>python flashcart-writer.py {path to bin file}/flashcart-image.bin</code>		# open a command window and navigate to the directory where the Python Utilities were expanded to. Run the command <code>python flashcart-writer.py {path to bin file}/flashcart-image.bin</code>


	== Adding a Game to the Cart ==		== Adding a Game to the Cart ==
Line 103:		Line 96:
	** send a PM via the forum to user @filmote to indicate that you have uploaded a game. The game is not made publicly visible automatically and are approved manually.		** send a PM via the forum to user @filmote to indicate that you have uploaded a game. The game is not made publicly visible automatically and are approved manually.
	** only the author of the game should do this as games are published only with the author's permission.		** only the author of the game should do this as games are published only with the author's permission.


	=== Adding a Game to the Cart using an .arduboy file ===		=== Adding a Game to the Cart using an .arduboy file ===
Line 117:		Line 109:
	# fill in any missing fields as per the [[#Adding a Game to the Cart using Individual Files]] section above.		# fill in any missing fields as per the [[#Adding a Game to the Cart using Individual Files]] section above.
	# click 'Upload' to complete.		# click 'Upload' to complete.


	== Category Maintenance ==		== Category Maintenance ==

	The Cart Builder allows you to add, delete and rearrange categories.		The Cart Builder allows you to add, delete and rearrange categories.


	=== Rearranging Categories ===		=== Rearranging Categories ===
Line 130:		Line 120:
	# categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or [[File:ArrowRight.png]] icons under the category image.		# categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or [[File:ArrowRight.png]] icons under the category image.
	# categories can be moved to the far left or far right by clicking [[File:ArrowLeftMost.png]] or [[File:ArrowRightMost.png]] icons under the category image.		# categories can be moved to the far left or far right by clicking [[File:ArrowLeftMost.png]] or [[File:ArrowRightMost.png]] icons under the category image.


	=== Deleting Categories ===		=== Deleting Categories ===

	# categories can be deleted by clicking the [[File:Delete.png]] icon under the category image. Any existing games in that category will be moved to the left hand side of the page allowing you to add them to other categories.		# categories can be deleted by clicking the [[File:Delete.png]] icon under the category image. Any existing games in that category will be moved to the left hand side of the page allowing you to add them to other categories.


	=== Creating a new Category ===		=== Creating a new Category ===
Line 157:		Line 145:

	# drag and drop the newly created category image on top of the existing category image to replace the image.		# drag and drop the newly created category image on top of the existing category image to replace the image.

			== Saving and Restoring a Cart ==
			The Cart Builder allows the user to save and restore a custom cart using the Dowload CSV and Upload CSV options, respectively.

			[[File:CartBuilder SaveRestoreCSV.png\|thumb]]


			Flashcart_Format

Filmote: /* Category Maintenance */

2024-06-19T09:54:55Z

Category Maintenance

← Older revision		Revision as of 09:54, 19 June 2024
Line 122:		Line 122:

	The Cart Builder allows you to add, delete and rearrange categories.		The Cart Builder allows you to add, delete and rearrange categories.


	=== Rearranging Categories ===		=== Rearranging Categories ===
Line 129:		Line 130:
	# categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or [[File:ArrowRight.png]] icons under the category image.		# categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or [[File:ArrowRight.png]] icons under the category image.
	# categories can be moved to the far left or far right by clicking [[File:ArrowLeftMost.png]] or [[File:ArrowRightMost.png]] icons under the category image.		# categories can be moved to the far left or far right by clicking [[File:ArrowLeftMost.png]] or [[File:ArrowRightMost.png]] icons under the category image.


	=== Deleting Categories ===		=== Deleting Categories ===

	[[File:~~CartBuilder_DeleteCategory~~.~~gif\|thumb~~]]		# categories can be deleted by clicking the [[File:Delete.png]] icon under the category image. Any existing games in that category will be moved to the left hand side of the page allowing you to add them to other categories.

	# categories can be deleted by clicking the [[File:Delete.png]] icon under the category image. Any existing games in that category will be moved to the left hand side of the page allowing you to add them to other categories.

	=== Creating a new Category ===		=== Creating a new Category ===

Filmote: /* Category Maintenance */

2024-06-19T09:54:19Z

Category Maintenance

← Older revision		Revision as of 09:54, 19 June 2024
Line 129:		Line 129:
	# categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or [[File:ArrowRight.png]] icons under the category image.		# categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or [[File:ArrowRight.png]] icons under the category image.
	# categories can be moved to the far left or far right by clicking [[File:ArrowLeftMost.png]] or [[File:ArrowRightMost.png]] icons under the category image.		# categories can be moved to the far left or far right by clicking [[File:ArrowLeftMost.png]] or [[File:ArrowRightMost.png]] icons under the category image.


	=== Deleting Categories ===		=== Deleting Categories ===
Line 136:		Line 135:

	# categories can be deleted by clicking the [[File:Delete.png]] icon under the category image. Any existing games in that category will be moved to the left hand side of the page allowing you to add them to other categories.		# categories can be deleted by clicking the [[File:Delete.png]] icon under the category image. Any existing games in that category will be moved to the left hand side of the page allowing you to add them to other categories.


	=== Creating a new Category ===		=== Creating a new Category ===

Filmote: /* Category Maintenance */

2024-06-19T09:53:18Z

Category Maintenance

← Older revision		Revision as of 09:53, 19 June 2024
Line 125:		Line 125:
	=== Rearranging Categories ===		=== Rearranging Categories ===

	[[File:~~CartBuilder_DeletedCategory~~.gif\|thumb]]		[[File:CartBuilder_DeleteCategory.gif\|thumb]]

			# categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or [[File:ArrowRight.png]] icons under the category image.
			# categories can be moved to the far left or far right by clicking [[File:ArrowLeftMost.png]] or [[File:ArrowRightMost.png]] icons under the category image.


			=== Deleting Categories ===

			[[File:CartBuilder_DeleteCategory.gif\|thumb]]

			# categories can be deleted by clicking the [[File:Delete.png]] icon under the category image. Any existing games in that category will be moved to the left hand side of the page allowing you to add them to other categories.

	~~Categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or~~

	=== Creating a new Category ===		=== Creating a new Category ===

Filmote: /* Category Maintenance */

2024-06-19T09:50:17Z

Category Maintenance

← Older revision		Revision as of 09:50, 19 June 2024
Line 125:		Line 125:
	=== Rearranging Categories ===		=== Rearranging Categories ===

	Categories can be moved		[[File:CartBuilder_DeletedCategory.gif\|thumb]]

			Categories can be moved one column to the left or right by clicking [[File:ArrowLeft.png]] or

	=== Creating a new Category ===		=== Creating a new Category ===

Filmote: /* Category Maintenance */

2024-06-19T09:46:42Z

Category Maintenance

← Older revision		Revision as of 09:46, 19 June 2024
Line 120:		Line 120:

	== Category Maintenance ==		== Category Maintenance ==

			The Cart Builder allows you to add, delete and rearrange categories.

			=== Rearranging Categories ===

			Categories can be moved

	=== Creating a new Category ===		=== Creating a new Category ===

Filmote at 09:41, 19 June 2024

2024-06-19T09:41:22Z

← Older revision		Revision as of 09:41, 19 June 2024
Line 119:		Line 119:


	== Creating a new Category ==		== Category Maintenance ==

			=== Creating a new Category ===

	[[File:CartBuilder_CreateCategory.gif\|thumb]]		[[File:CartBuilder_CreateCategory.gif\|thumb]]

Filmote at 10:21, 18 June 2024

2024-06-18T10:21:17Z

← Older revision		Revision as of 10:21, 18 June 2024
Line 119:		Line 119:


	=== Creating a new Category ===		== Creating a new Category ==

	[[File:CartBuilder_CreateCategory.gif\|thumb]]		[[File:CartBuilder_CreateCategory.gif\|thumb]]