The Booksales Data Map project is an Electron application designed to visualize book sale events across different states in the U.S. It pulls HTML sales data from https://www.booksalefinder.com/, parses it using JSDOM, stores it for future use, and displays the information using Leaflet on an interactive map. This project leverages Electron Forge for simplifying the build process and managing the application lifecycle.
If you want an exe of this project, just message me through 20cmulholland@gmail.com and I'll compile and upload one through this github page.
- Loads Book Sale Data: Scrapes and parses book sale data from
https://www.booksalefinder.com/to display on an interactive map. - Data Storage: Stores parsed data in a CSV file for easy access and manipulation.
- Search and Filter: Allows users to search and filter book sale events by state.
- User Data: Users can create their own data by filling out a form and submitting it to the map.
- User Update: Users can update their data by entering the index of the place they want to update and then filling out the form.
- Electron Application: Built with Electron, providing a native desktop application experience across Windows, macOS, and Linux.
- Data Scraping and Parsing: The user uploads an HTML document which JSDOM parses
- Interactive Map Visualization: Displays book sales data on an interactive map using Leaflet.js, offering a user-friendly interface for exploring events.
- Electron Forge Integration: Uses Electron Forge for building, running, and packaging the application, streamlining development and deployment processes.
-
Scraping and Parsing Data: This application uses JSDOM to parse HTML data from
https://www.booksalefinder.com/and extract information about book sale events in different states across the U.S. -
Storing and Updating Data: Scraped data is stored in a CSV file for easy access and manipulation. Users can update this data by triggering the Python script through the Electron interface.
-
Visualizing Data: The frontend, built with HTML, CSS, and JavaScript, reads the CSV data and uses Leaflet.js to display each book sale event on an interactive map. Users can search and filter events by state, as well as add their own data to the map using EasyMDE for Markdown display and conversion to HTML.
-
Electron Forge: Facilitates development with hot reloading during development and simplifies the process of packaging the application for distribution.
- Frontend: HTML, CSS, JavaScript, Leaflet.js, EasyMDE
- Backend: NodeJS, JSDOM
- Desktop Application: Electron, Electron Forge
- Data Storage: CSV
- You can download the program using the link below, or by clicking the "Releases" text on the right panel and downloading the .zip file.
- Download Program
- After downloading this .zip file, right click it and "extract" it. After doing that, find the .exe file in the subfolder, and double click it to run the program. You may need to allow the program to access ports, and after that the program should be running properly.
- You can make a shortcut to the .exe by right clicking it and selecting "create shortcut", which you can drag to your desktop.
- Clone the Repository:
- Navigate to the Project Directory:
- cd Library-Sale-Finder
- Install Dependencies:
- For Node.js and Electron:
npm install
- Run the Application with Electron Forge:
npm start
Electron Forge makes it easy to package and distribute your application. To package your app for your current platform:
npm run make
This command will create a distributable package in the out directory.
Contributions are welcome! Feel free to submit pull requests for bug fixes, features, or improvements to the code or documentation.
This project is licensed under the MIT License - see the LICENSE file for details.